Skip to content

docs: document embedsMetadata form field#43

Merged
gulien merged 1 commit intogotenberg:mainfrom
Jean-Beru:docs/embeds-metadata
Apr 17, 2026
Merged

docs: document embedsMetadata form field#43
gulien merged 1 commit intogotenberg:mainfrom
Jean-Beru:docs/embeds-metadata

Conversation

@Jean-Beru
Copy link
Copy Markdown
Contributor

Summary

Documents the changes introduced in gotenberg/gotenberg#1521:

  • New embedsMetadata form field on the Chromium (URL/HTML/Markdown), LibreOffice, PDF Engines Merge and PDF Engines Split routes.
  • New POST /forms/pdfengines/embed route section (covering both embeds and embedsMetadata).
  • New --pdfengines-embed-metadata-engines / PDFENGINES_EMBED_METADATA_ENGINES flag (default qpdf).

The new field writes /Subtype on embedded file streams, /AFRelationship on file specifications, and populates the Document Catalog /AF array, which is what Factur-X / ZUGFeRD validation requires.

Test plan

  • npm run build passes (no new broken anchors introduced).
  • Visual check of the new Embedded Files subsections under Chromium and LibreOffice.
  • Visual check of the new Embed files into a PDF route section.
  • Visual check of the --pdfengines-embed-metadata-engines row in the PDF Engines configuration table.

@Jean-Beru Jean-Beru marked this pull request as draft April 17, 2026 07:36
@Jean-Beru Jean-Beru force-pushed the docs/embeds-metadata branch 4 times, most recently from e02752f to f687240 Compare April 17, 2026 08:55
@Jean-Beru Jean-Beru marked this pull request as ready for review April 17, 2026 08:56
@Jean-Beru Jean-Beru force-pushed the docs/embeds-metadata branch from f687240 to 4f09ba7 Compare April 17, 2026 09:13
@Jean-Beru Jean-Beru force-pushed the docs/embeds-metadata branch from 4f09ba7 to 6bbb093 Compare April 17, 2026 09:22
@gulien gulien merged commit 94a9476 into gotenberg:main Apr 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants