cloudformatter format requests: 1,137,566    pages delivered: 2,940,389

PDF Properties

xportability LLC

PDF Properties


Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).


You use the (optional) tag <pdfproperties> and within that tag you can insert <metainfo> and <pdfpreferences> sections as shown in the instructions below. Within the <metainfo> tag, you can add <prop> tags with @name, @value attribute pairs with the data you wish to store in the PDF metadata. Anything without one of the recognized, standard PDF names (author, title, subject, creator, keywords) are stored in custom metadata in the PDF.

The <pdfpreferences> section allows you to insert one or more <pref> tags with specific @name, @value pairs that control the way the resulting PDF is displayed with a viewer that supports standard PDF view attributes. The support name, @value pairs are listed below and grouped into all the available categories:

General PDF Options

These options let you control some general information about the generated PDF.

bookmarks - sets whether PDF bookmarks are generated or not. The default is "false" for Cloudformatter. You can set @value to "true" if you want bookmarks in PDF. Note that bookmarks are only generated for interpreted hierarchical information. All h1 elements and there following h2 elements and so on. Skipping levels will break the sequence and the bookmarks will not be correct.

pdf-version - sets the PDF version number. The default is version 1.5 for Cloudformatter but you set @value to values like "1.3", "1.4", "1.6" or "1.7" if you wish to change the version. Be aware thar some other features could be disabled by setting the version too low.

compress - sets whether the PDF is compressed or not. The default is "true" for Cloudformatter. You can set @value to "false" if you want uncompressed PDF.

linearize - sets whether the PDF is linearized or not. The default is "false" for Cloudformatter. You can set @value to "true" if you want to optimize a long PDF for web view.

PDF View Options

These options let you control how the PDF when opened appears to the end user.

view-mode - Choose from one of the following:

  • auto - If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.
  • show-none - All auxiliary panes are hidden.
  • show-bookmarks - The bookmarks pane is displayed.
  • show-thumbnails - The thumbnails pane is displayed.
  • full-screen - The document is displayed in full screen-mode.

initial-zoom - Choose from one of the following:

  • auto - Page scaling is not specified.
  • fit - The page is scaled to fit completely into the view port.
  • fit-width - The page is scaled so that its width matches the width of the view port.
  • fit-height - The page is scaled so that its height matches the height of the view port.
  • ### or ####% - The page is scaled by the number or percentage specified.

page-layout - Choose from one of the following:

  • auto - Uses settings of viewer application.
  • single-page - Displays one page at a time.
  • continuous - Displays pages continuously in one column.
  • two-columns-left - Displays pages continuously in two columns, with odd-numbered pages to the left.
  • two-columns-right - Displays pages continuously in two columns, with odd-numbered pages to the right.
  • two-pages-left - Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.
  • two-pages-right - Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.

viewer-preferences - A comma separated list of the following possibilities:

  • hide-toolbar - Hides the viewer application's tool bars when the document is active.
  • hide-menubar - Hides the viewer application's menu bar when the document is active.
  • hide-window-ui - Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.
  • fit-window - Resizes the document's window to fit the size of the first displayed page.
  • center-window - Positions the document's window in the center of the screen.
  • display-document-title - Controls whether the window's title bar displays the document title taken from the "title" metadata field.

PDF Security

These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).

userpassword - Sets the user password that must be entered to view the PDF. There are no options, the @value passed is the password to be used.

ownerpassword - Sets the owner password that must be entered to enable advanced processing of the PDF. There are no options, the @value passed is the password to be used. An ownerpassword is used to lock down certain privledges that an owner will grant to a recipient of the PDF. Without the owner password, recipients can be restricted from certain things. By default they are restricted from everything, and you can then specify what additional things you allow by using userpriviledges.

userpriviledges - A comma separated list of the following possibilities:

  • print - Enables printing the document.
  • modify - Enables editing the document.
  • copy - Enables copying text and images from the document to the clipboard.
  • annotate - Enables adding notations to the document and changing the field values.

PDF Pre-Press Options

These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.

crop-offset - specify offsets from the meaningful content on the page to the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from the edges of the page area to the corresponding edges of the /MediaBox. Rules for expanding the value are the same as for the padding property in CSS.

bleed - specify the bleeds — an extra space around the page area into which the contents of the page may protrude (/BleedBox entry in the PDF page dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from the edges of the page area to the corresponding edges of the /BleedBox. Rules for expanding the value are the same as for the padding property in CSS.

crop-mark-width - defines line width for the crop marks, setting it to 0 disables drawing of crop marks.

bleed-mark-width - defines line width for the bleed marks, setting it to 0 disables drawing of bleed marks.

printer-mark - specify additional SVG images to be drawn in the offset area surrounding the page (specified by crop-offset and bleed parameters). Printer marks are clipped to the outside of the bleed rectangle. The @value is a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a registration mark) you can also use if you like.

The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.


Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.

<pdfproperties style="display:none;">
        <prop name="author" value="Xportability LLC"></prop>
        <prop name="title"
            value="Xportability Cloudformatter: Showing Custom
            PDF Properties"></prop>
        <prop name="subject" value="A Cloudformatter Document"></prop>
        <prop name="creator" value="css2pdf@cloudformatter.com"></prop>
        <prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
        <prop name="custom1" value="value1"></prop>
        <prop name="custom2" value="value2"></prop>
        <prop name="custom3" value="value3"></prop>
        <prop name="custom4" value="value4"></prop>
        <pref name="bookmarks" value="true"></pref>
        <pref name="pdf-version" value="1.6"></pref>
        <pref name="view-mode" value="auto"></pref>
        <pref name="initial-zoom" value="fit-height"></pref>
        <pref name="page-layout" value="two-columns-left"></pref>
        <pref name="viewer-preferences" value="display-document-title"></pref>
        <pref name="crop-offset" value="0.5in"></pref>
        <pref name="crop-mark-width" value="1px"></pref>
        <pref name="printer-mark"
        <pref name="printer-mark"

Sample Output H2

Et magna ut adipiscing elit ut amet eirmod sea diam diam eirmod. Invidunt invidunt elit takimata sea dolore sea dolor. Dolor erat vulputate lorem et sit dolores. Rebum sit aliquyam consetetur. Volutpat tempor erat lorem luptatum duo tincidunt. Ipsum amet congue et accusam dolores et kasd amet dolore vero nonummy diam dolores eos. Diam invidunt amet et euismod wisi voluptua et accusam vulputate eleifend dolore nam no sit diam sit ea. Dolores elitr invidunt sanctus consequat labore possim dolor ipsum odio adipiscing tincidunt blandit rebum. Nonumy nibh justo tempor iriure lorem justo eu sit amet dolores accusam. Tempor tempor accusam duo at in. Ipsum sed in erat consequat ut magna clita ut nonumy et dolor luptatum dolore et lorem eirmod ut volutpat.

Nulla diam clita nibh vel amet amet kasd ut rebum delenit. Voluptua et lorem tempor et et no eos takimata clita takimata labore justo lorem lobortis dolores et lorem. Diam cum placerat diam sit diam sed. Ut et magna. Voluptua ut esse est euismod iusto duo sanctus sea voluptua consectetuer nulla wisi gubergren duis. Elitr sed dolores consetetur dolor est feugait. Lorem dolore dolor vero vero consetetur nulla takimata sanctus veniam magna. Magna amet sed dolore lorem. Labore dolor duo et iusto ea labore amet dolor sea amet et magna hendrerit. Et magna eum feugait clita ex. Diam euismod dolor lorem dolor stet sed sadipscing lorem diam sed sea accusam dolor ut stet sadipscing minim diam.

Sample Output H3

Ex in aliquyam molestie tation eos. Nihil sit tempor. Voluptua et no at. Qui aliquip accusam odio eirmod sea. Dolor takimata justo consequat duis. Diam dolor eos voluptua amet invidunt ipsum eos assum nostrud sed imperdiet no dolore ipsum sed. Eleifend tempor illum. Accumsan clita ea eirmod diam mazim magna luptatum diam hendrerit quod nonumy. Rebum sed ea justo velit vero est no et elitr rebum no eos diam. Sanctus at velit kasd dolore dolor augue ut molestie. Iusto rebum eos.

Dolores kasd sea et justo erat diam adipiscing gubergren no voluptua. No justo sanctus erat tempor ea et nonumy. Sanctus consequat ut cum duo sanctus sed illum et. Et vulputate aliquam at dolor. Takimata elitr sit nonumy consetetur euismod magna est ipsum labore et feugiat in dolor ipsum feugiat kasd sed dolore. Labore magna nisl vero ipsum amet. Justo voluptua consetetur consequat consetetur no consetetur congue vero sed sit laoreet autem commodo dolor ullamcorper stet nonumy magna. Eu sit aliquip facilisis vel dolor rebum duo. Nonumy nonumy et consetetur commodo aliquyam erat ipsum ipsum.

Sample Output H4

Sit odio et dolor kasd labore ipsum. Eleifend at dolor labore consequat magna et eos eum sit eirmod wisi amet voluptua lorem et. Dolor sit sit voluptua eos ea vel dolores. Ipsum amet voluptua autem et adipiscing amet dolor. Illum dolores est euismod vel justo sanctus lobortis ipsum nihil. Diam sea enim at stet accusam eirmod sit consetetur. Sed sit sit diam erat sit duo consetetur ipsum facilisis ea dolor feugait et sit volutpat. Et dolore amet duo option dolor sea vel at autem aliquyam velit diam consetetur lorem lorem takimata veniam et. Luptatum tempor duo velit ullamcorper dolore et gubergren. Lorem commodo ut quis nonumy sanctus rebum duis sadipscing laoreet amet diam magna aliquip magna accusam diam sadipscing eirmod. Dolor invidunt ut option ipsum sed sit.

Sadipscing dolore voluptua amet praesent sed dolor et at magna. Hendrerit nostrud ea invidunt stet eu magna consequat clita invidunt gubergren tincidunt eos minim clita eu accusam. Minim dolor no. Dolor et no. Diam consequat iusto ut sit sit sit gubergren et lorem eirmod sanctus rebum ut sea.

Sample Output H4

At gubergren et ipsum et et magna voluptua dolor. Erat no hendrerit tation ipsum voluptua rebum sadipscing eos lorem volutpat at. Erat vel vero dolores consetetur. Nibh sed sadipscing. Dolor diam sanctus soluta est et magna at aliquip vero duo luptatum. Ut eum invidunt aliquyam. Elitr vel sit amet duo consetetur stet vero erat amet accusam amet nisl est odio. Elitr nonummy hendrerit sadipscing in eos. Elitr et augue.

Eu possim lorem accusam invidunt ea invidunt iriure eirmod consequat. Clita nonumy aliquyam diam. Et sed sanctus eu amet sit in sit adipiscing. Ullamcorper molestie in lorem feugiat invidunt dolor commodo hendrerit takimata sit. At elitr invidunt erat vero augue.

Sample Output H3

Lorem clita lorem kasd sed stet tation duo. Ad kasd et facilisi congue no ut zzril duo feugiat. Ea esse vero ea nisl ut dolore rebum sit. Iriure ea dolor dolores aliquip. In amet rebum duo et sit et voluptua consequat. Sed iriure gubergren.

Vero dolor justo delenit amet accumsan labore sea odio magna in eirmod wisi. Feugiat sanctus lorem dolor dolores sed eirmod est stet dolor et nisl et vulputate nibh iriure. Luptatum nulla vulputate enim sit consetetur ipsum ut justo est mazim et. Takimata takimata et dolor. Et suscipit congue magna tation. Et labore sit facilisis at sed nulla amet ipsum autem sed aliquyam magna euismod no vel assum amet. Sanctus in consequat diam nibh clita diam diam dignissim takimata invidunt sanctus illum et eos.

Sample Output H4

Diam placerat in accumsan tincidunt elitr sed gubergren aliquyam at ut amet. Dolor dolores blandit adipiscing justo takimata facer takimata liber. Eirmod amet amet sadipscing sea esse clita ipsum elitr sed sit ut. Nonumy placerat amet. Et vel eleifend duo nonumy et lorem ea et nonumy. Stet et takimata te. At tempor vero aliquyam eirmod sit accusam consectetuer zzril elitr dolores vulputate accusam.

Sadipscing molestie vero accusam diam sanctus lorem lorem aliquip amet diam. Ea ad labore diam accusam est rebum et ut praesent et ut wisi erat ea. Zzril amet consetetur amet lorem. Sanctus id sed ut lorem ut at eirmod iriure. Sanctus diam accusam eos feugiat zzril doming lobortis nibh lorem nonummy id dolore nulla et kasd.

Sample Output H4

Et eleifend ut et no est iusto sea dignissim ut amet diam vel ipsum voluptua ea erat. Tation tincidunt diam sit vero velit consequat lorem dolores magna diam commodo amet sadipscing sit sed sanctus. Amet laoreet justo molestie. Eos consetetur et cum autem dolore aliquyam justo ea nibh et ipsum. Diam dolore voluptua sit magna no velit nostrud feugiat duo clita sea. Duo elitr et diam at est vero sadipscing labore. Duis et tempor sed dignissim clita duis et eirmod nonumy rebum nonumy vero luptatum accusam at diam dolore at. Voluptua eos imperdiet ipsum erat eirmod invidunt clita diam tincidunt. Nonumy sanctus voluptua doming. Consetetur autem justo. Labore sit et duo dolor nulla duo.

Labore augue sit sit iriure aliquyam voluptua hendrerit nonumy rebum aliquip doming amet ea delenit gubergren quod. Magna sanctus erat rebum luptatum ut ipsum dolore aliquyam sed diam dolor lorem ea illum veniam. Kasd soluta tempor et sit justo dolor nonumy erat ipsum sit labore clita ipsum sea. Consectetuer liber sit eirmod justo clita aliquip lorem dolores amet justo ea elitr consetetur. Diam est magna dolor nibh nam et dolor et diam sea lorem sed stet lorem amet. Dignissim ipsum diam augue takimata hendrerit dolores lorem dolor labore zzril sit option tempor sit invidunt lorem sea delenit. Eleifend amet odio. Accusam euismod kasd clita nulla enim sed.

More Sample Output H2

Feugiat ad eirmod est ut eirmod ad dolor dolor at odio invidunt velit nonumy suscipit illum. Et esse elitr odio ullamcorper et et tincidunt tincidunt dolore feugiat. Vulputate dolor sadipscing lobortis sed labore et takimata eu sit et ut labore clita et labore. Lorem clita accusam autem no feugait ipsum et quis consetetur consetetur. Autem at ullamcorper autem sanctus. Voluptua sed eu takimata est amet vero sit duo duo takimata tempor dolor dolore lorem diam sanctus nulla. Feugait nonummy nulla diam labore et nulla ipsum nobis duo diam consequat accusam. Stet nulla et feugiat iriure rebum et et sea in justo sit magna dolore kasd sanctus odio adipiscing at. Magna invidunt ut esse et vel sit dolore in wisi sed lorem lorem. Sit sit amet nonumy justo eu. Labore ut dolores possim.

At velit dolore enim ad facilisi labore eum sit erat labore. Iusto duo lorem ut exerci lorem ea elitr erat ipsum kasd eu tempor. Sadipscing dolore erat stet sit amet sed. Accusam ut iriure lorem sit eum clita rebum duo lobortis kasd amet ipsum delenit no. Ea duo tincidunt sit molestie. Et amet eirmod sit ea iusto molestie amet duis ut sanctus nisl sit ea vero lorem. Ipsum lorem et ipsum laoreet justo magna minim stet accusam illum ipsum. Quod et illum elit hendrerit ad ea iriure amet sed nihil ut. Nibh diam duis soluta consetetur vel nibh veniam voluptua vero molestie ipsum ipsum dolore sed accusam dolor dolor. Consectetuer amet gubergren takimata justo illum eos gubergren nonumy voluptua ipsum sea diam dolores nulla quis facer ipsum gubergren. Invidunt lorem ipsum stet sea clita sit eirmod magna at tincidunt ipsum adipiscing id.

Sample Output H3

Et et nulla et. Dolore invidunt ipsum ipsum et duo lorem amet odio clita duo sed sea dolores consectetuer voluptua diam ipsum takimata. Labore delenit no clita et autem in et diam. Nam erat velit voluptua accusam stet lorem duo veniam clita gubergren nostrud quod nonumy. Eos aliquam nonummy volutpat mazim voluptua ut consectetuer suscipit tempor et. Soluta facilisis et laoreet et et amet augue lobortis invidunt dignissim veniam ut facilisis et suscipit augue at hendrerit. At stet amet et ut nihil invidunt ut odio tincidunt dolor justo sit ipsum et nonumy in molestie nonumy. Lorem voluptua amet et ipsum. Dolor et est ea eos. Et lorem cum lorem ipsum ipsum vero in aliquyam diam diam aliquyam ut invidunt.

Gubergren et rebum sed justo vero. Lorem stet facilisis dignissim et. Et aliquyam et tempor et dolor dolor et dolore vero. Erat nulla dolore accusam lorem justo volutpat sit sit et. Et illum magna kasd nonumy diam nonumy sed blandit clita ipsum ipsum gubergren sit est consetetur rebum eirmod consetetur. Ut no accusam sed sea doming amet lorem consetetur no. Tempor at rebum no suscipit. Vero rebum sed aliquyam consequat takimata magna consetetur consectetuer et at amet vel tation ipsum. Ut exerci rebum nonumy consequat lorem sanctus diam nonumy autem.

Sample Output H4

Amet lorem sit eirmod volutpat accusam tempor invidunt lorem nisl eum. Voluptua dolores at vero at. Praesent accusam amet kasd qui at amet diam ipsum accumsan ut ea sed tempor. Odio sed sed voluptua tempor consequat eos dolor sit sit ipsum vero sit. Et sed eirmod ut cum ea takimata consetetur et invidunt ipsum elitr at soluta erat ut. Clita no in eirmod sanctus et ipsum.

Erat erat lorem wisi nobis. Dolore takimata dolores sit dolor stet liber et voluptua. Consetetur est lorem amet sanctus et et et clita vero. Sea ea ea. Sea dolor duis et eirmod consetetur vulputate lorem sadipscing gubergren duo velit soluta tempor voluptua takimata.

Sample Output H4

Voluptua kasd erat consetetur dolor consectetuer sea doming labore nisl hendrerit nibh. Elitr ipsum duo. Esse sea dolor tempor duo nibh justo sanctus ut sanctus. Nonumy nihil ut duo dolore rebum eirmod molestie et rebum soluta clita adipiscing sanctus. Et nostrud magna labore no molestie labore aliquyam quis lorem labore sed diam ut euismod ea no consetetur.

Suscipit justo et duis facilisis tempor lorem dolor consetetur dolore dolor accusam no sea mazim sanctus aliquyam. Autem duo est eu quod justo. Nonumy nulla dolor sanctus congue. Dolores at et et amet ipsum. Iusto sanctus ut eos odio vero ipsum sed. Justo sea tempor labore sea dolor tempor dolor esse at in stet in vulputate dolor. Quis vero veniam rebum eirmod illum no ipsum. Stet elitr enim facilisi sit ea et accusam takimata dolore ullamcorper erat quis sit et eirmod. Sit suscipit erat. Dolore labore et ea takimata lobortis. Rebum nulla et dolor ut magna consetetur est assum feugiat eros no.

Sample Output H3

Dolore aliquyam erat sit lorem. Id dolor duo et justo facer no dolore ut kasd diam eirmod eu at. Ipsum tempor elitr molestie diam sanctus ea adipiscing quis sadipscing delenit lorem diam volutpat et ut ullamcorper sea. Clita diam feugait ut dolore minim lorem stet duis hendrerit nonumy eirmod commodo sit molestie ut consequat. Nonummy gubergren lorem facilisis no voluptua ullamcorper ut amet illum consectetuer tation dolore soluta no. Eu dolor eirmod elitr nostrud accusam eros consetetur vulputate sea accusam lorem labore feugait. Eos dolores lorem at lorem dolore sit sed labore eros sit exerci dolores amet nonumy et.

Duo lorem labore aliquyam consetetur lorem accumsan gubergren voluptua sadipscing dolor est et sanctus elitr sed labore diam. Hendrerit ea nihil ea elitr velit dolores ipsum. Sea sed consequat in et nulla et feugiat diam dolor et sit sit consequat. At diam clita est nonumy magna doming et lorem nonummy amet. Esse duis dolore in nostrud tincidunt rebum. Sed quis sadipscing tempor diam vero diam sit eos esse ullamcorper ut delenit dolor.

Sample Output H4

Tincidunt amet sea sea magna clita congue labore nonumy tempor clita nibh quis kasd gubergren dolor aliquip et justo. Ut vero et molestie nonumy doming praesent consequat et tempor erat lorem. Doming lorem sit dolores nisl sed wisi et no autem dolor kasd ipsum. Tempor euismod clita et sea dolore amet magna blandit sed vero justo ut amet. Erat invidunt sea at clita duo stet nonummy diam ipsum dolor iusto rebum voluptua diam rebum ut tempor. Zzril takimata gubergren ea velit tempor commodo veniam rebum vero elitr sit sadipscing et sit aliquyam. Consetetur invidunt luptatum. At dolor ipsum vero clita erat option est nibh delenit et et nulla congue sea. Hendrerit diam accusam et et eu lobortis invidunt nonumy et invidunt rebum et ipsum ut vulputate accusam ut facer.

At diam at lorem at. Nulla lorem liber elit accusam. Kasd dolor nonumy nulla consetetur. Et veniam et at sed consetetur. Vel sanctus sea dolore clita iriure sea magna erat ipsum gubergren dolore eos imperdiet consetetur sed.

Sample Output H4

Suscipit rebum dolore aliquam takimata magna et. Justo lorem duo vero augue molestie dolore delenit lorem id erat accumsan quod labore rebum nulla. Sadipscing aliquyam eu et eirmod dolore molestie voluptua lorem. Augue diam at suscipit diam sadipscing ut facilisis in stet aliquyam cum sea sit no. Duo nonummy accusam et velit consequat sed sit vel dolor at est ea dolores et consequat feugait. Dolor duo vero diam sed ea et nulla accusam et rebum velit et. Stet takimata rebum takimata dolores tempor minim dolor sanctus vero.

Ut minim veniam at erat amet sadipscing accusam eu elitr facilisi sed invidunt in. Erat facilisis no lobortis nulla erat dolore et sea ipsum diam dolore. Sea est sit sit duo et ea. Ea sit lorem te iriure sit et odio labore dignissim et consetetur erat dolore velit diam labore ipsum. Placerat eos ea eos ipsum labore sed stet autem erat invidunt sea. Voluptua ut ea molestie sanctus ipsum clita erat kasd tempor eum labore eirmod dolor diam exerci justo congue. Sit odio eos amet eos eos labore voluptua ut eirmod aliquyam sed gubergren nulla qui qui sadipscing amet dolor. Diam ut consequat eum justo gubergren nonumy sit sadipscing. Stet laoreet amet vero nulla. Dolore sed labore kasd est accusam takimata ut in at labore. Aliquam esse et voluptua duo et zzril dolore.