cloudformatter format requests: 6,189,789    pages delivered: 14,123,021

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

Facilisis clita sadipscing sadipscing. Ipsum et invidunt amet et est cum nonumy ut vel sadipscing clita sit volutpat tempor. Eum praesent te sed erat invidunt no nisl. Velit laoreet dolor adipiscing quis et no consetetur sadipscing est. Sed sea assum elitr et et voluptua elitr consetetur elitr consetetur erat sadipscing et nibh. Ut lorem accusam commodo amet ipsum kasd diam ea et ut diam sed sit labore. Amet labore eum takimata erat vulputate. Sit ipsum dolores minim et facilisis est no esse et ipsum tation erat et sanctus lorem stet. Kasd consetetur est takimata lobortis rebum sadipscing at at est. Vulputate voluptua ut aliquyam takimata et amet.

Lobortis ut gubergren takimata eirmod. Vero sea lorem ad eum aliquyam nulla kasd vel sadipscing lorem consetetur. Soluta justo dolores nonumy. Labore dolore dolore dolor feugiat et sit takimata. Sed sadipscing amet labore dolor qui lorem nonumy ex et nulla clita delenit amet amet dolore. Ipsum vero takimata amet ut diam sanctus.

Sample Output H3

Kasd dolore et diam kasd wisi amet gubergren cum. Ipsum sed takimata exerci amet duis. Magna elit et ex eleifend duo. Voluptua justo sea illum ipsum tation velit ea in tincidunt voluptua et duo elitr. Diam kasd aliquip te eros sadipscing eu sit. Amet aliquam blandit takimata feugiat vulputate eirmod kasd amet aliquip amet sit sea dolor takimata elitr. Eirmod ea aliquip dolore iriure id vero placerat ipsum dolor lorem diam nulla sadipscing ea eos et justo amet. Ad tempor dolor dolor zzril voluptua dolore sed kasd et no autem enim nihil sanctus diam rebum accusam. Sed dolor amet sit amet.

Sit amet lobortis invidunt invidunt clita. Amet magna amet consequat ea dolor wisi. Labore aliquyam labore dolor et at amet lorem esse eros sit et eirmod et labore nostrud sanctus. Kasd ut tempor est eirmod et erat eos et et. Kasd commodo tempor takimata rebum dolore ipsum stet.

Sample Output H4

Consequat mazim nulla et diam ut kasd consequat dolor. Ullamcorper dolor tempor velit sed diam eum sadipscing dolores nonumy duis exerci sed sit nulla. Wisi stet vero est rebum dolor doming no eirmod luptatum stet possim at dolore justo est amet. Dolore sit clita aliquyam. Eirmod rebum diam sit diam sed nonumy augue kasd takimata cum aliquyam ipsum stet nihil consequat sit lorem. At euismod eu takimata sit ex clita elitr sea voluptua ea elitr. Consectetuer dolor clita diam odio duo sanctus duo sadipscing tempor nobis dolore et sadipscing ipsum elitr ipsum vulputate qui. Commodo eos feugait invidunt takimata no quis lorem lorem magna lorem dolor.

Esse sit consetetur nisl clita amet vero ullamcorper et eirmod. At erat dolore delenit labore nonumy facilisi dolor at labore sit takimata amet et stet laoreet sit justo clita. Suscipit vel est eos eos elit magna et nulla. Sed sed accusam sadipscing dolore dolore lorem. Sit tation aliquyam lorem diam ipsum et consetetur ipsum et adipiscing in consetetur sanctus. Accusam id sea feugait eirmod elitr consectetuer at. Ullamcorper praesent elitr. Invidunt consequat sit luptatum in sadipscing lorem sit consequat suscipit imperdiet justo ipsum at dolor et sed accusam.

Sample Output H4

Ipsum labore elit quod molestie clita et ipsum consequat lorem minim takimata dolor invidunt eros amet. Et duis dolor accusam ipsum justo diam clita et diam adipiscing amet. Diam ut diam eos assum dolor eirmod et erat erat gubergren suscipit. Molestie elitr nonumy sea kasd ipsum sed dolor sea sadipscing dolor autem eu magna in eum dolor. Volutpat elit justo no sed et. Ad vulputate takimata dolor est eu elitr et est option. Facilisi sit aliquyam diam gubergren kasd dolore sed takimata sea sanctus ut clita consetetur dolore no vero accusam. Euismod ea justo. No dolor dolores diam ipsum exerci.

Elitr duis nihil vero erat hendrerit. Dolore tempor diam invidunt stet ipsum eros justo amet lorem et facilisi labore amet at accusam dolore. Ex amet kasd sadipscing diam erat lorem dolor eros rebum sanctus ea ut. Sit et dolore elitr. Facilisis accusam molestie lorem amet. Dolores feugiat lorem possim erat.

Sample Output H3

Ea justo ipsum sed no illum gubergren. Et eu facer eum stet aliquyam et ipsum takimata. Stet illum est velit lorem clita magna eirmod est tation illum sit stet lorem dolor sit erat. Tincidunt no eos wisi dolore. Sea kasd ipsum sed dolore elitr justo consequat sit eirmod ullamcorper et velit erat odio. Iriure iusto diam et dolor quod luptatum vel eleifend sit. Ad facilisis eu erat clita consequat molestie nonummy tempor rebum. Sanctus minim facilisi et lorem vel no clita ullamcorper velit magna eirmod quis molestie. Ipsum et labore rebum dolore no magna et vero illum. Sea eos minim ipsum et erat consequat vero consequat eu te justo erat eos sanctus ipsum stet. Et vulputate ipsum ad.

Ut consetetur takimata ipsum magna at. Dolor labore sit invidunt dolore dolore lobortis ipsum feugiat invidunt diam labore no voluptua dolor sanctus. At liber dolor nonumy elitr sadipscing stet amet veniam diam ea sadipscing te dolor iriure in amet. Duo consetetur eirmod vero nisl sea nisl sit ut clita nibh gubergren ut et. Sit consetetur consetetur. Diam voluptua sed nonumy diam hendrerit eirmod nonumy diam accusam et feugiat sadipscing nonummy clita erat clita et illum.

Sample Output H4

Eu invidunt hendrerit. Ut commodo erat hendrerit eirmod at vero lorem blandit et labore duis sanctus dolor ut dolor. Nulla feugiat ipsum magna consequat dolor tempor. Voluptua minim vel duis erat amet invidunt. Eirmod nonumy eirmod no wisi et.

Enim no ipsum erat sit sanctus et lorem enim. Tempor quod duis et dolore eirmod vero stet kasd amet delenit dignissim magna sed dolore. Duo no ipsum quod. Eos magna sit illum sea ipsum in veniam accusam eum dolor magna lorem takimata kasd dolor. Et ut ut ea eu sit amet. Volutpat sadipscing luptatum at eirmod rebum dolor accusam tempor dolor eos dolor nisl sanctus ut labore et facer. Est velit ut odio et sea vel blandit. Exerci tempor stet et sit ut et sanctus gubergren accusam. Nonumy sea gubergren praesent. Aliquyam eos ipsum duo esse sit kasd eirmod lorem.

Sample Output H4

Sit accusam dolore dolore at dolore consetetur illum aliquip labore dignissim assum. Feugiat erat vero et suscipit at aliquyam facilisis duo elitr eleifend iriure ut duis lorem. Labore vero et consetetur no diam labore vel eos facilisis lorem. Nihil ut dolor blandit in voluptua eirmod accumsan diam. Lorem at facilisis sit praesent sed sit consequat diam diam invidunt eos erat sed option erat sit sed. Kasd voluptua et euismod zzril et dolores dolores.

Feugait doming aliquyam magna accusam. Dolor delenit rebum sed diam diam tempor invidunt dolor no et et et ipsum amet commodo. Erat adipiscing accumsan et volutpat rebum stet consequat dolore eos duo ea invidunt gubergren. Sea lorem soluta enim et wisi invidunt at accusam aliquyam. Sed nulla sit dolor nibh ipsum kasd lorem sit diam illum sadipscing commodo. Duo et no est duo tempor dolores lorem.

More Sample Output H2

Iriure qui justo amet vel velit te ipsum invidunt consetetur sanctus lorem dignissim erat consequat amet eirmod accusam no. Doming diam lorem erat. Consetetur rebum et eirmod. Takimata elitr rebum dolore. Kasd dolores amet consequat sit et sed sed est consetetur aliquyam. Feugiat tempor ea volutpat amet. Ut velit cum wisi diam sit cum sadipscing dolor kasd sadipscing accusam rebum nonumy. Facilisi nibh et quod lorem. Takimata erat clita dolore labore dolores et dolore praesent nisl. Sed erat et ea ipsum delenit kasd minim et lorem duis eum luptatum. Magna sed labore at gubergren lorem eos at sea clita.

Vel accusam et magna no velit clita ipsum vero sed at sed ipsum clita eirmod. Eirmod diam sadipscing esse sit labore ipsum diam eirmod nulla sanctus amet accusam diam sed dolores duis aliquip dolore. Erat ut consetetur at et wisi. Ipsum dolore exerci est. Kasd elitr aliquam lorem.

Sample Output H3

Augue nihil ipsum ullamcorper sadipscing ut et duis autem invidunt et tation consetetur labore aliquyam et. Ipsum duo sit lorem. Sanctus amet ea autem diam takimata duo sed autem autem dolore kasd sed ipsum eirmod in gubergren no sed. Vero consequat lorem justo dolore eirmod justo lorem nonumy invidunt rebum duo gubergren id clita. Sed autem magna voluptua consetetur ea. Qui sadipscing eum sadipscing gubergren erat et voluptua. Sed volutpat amet iriure sit iriure vero dolores nonumy duo possim minim elit rebum sanctus. Et velit eleifend exerci sed et kasd elitr diam justo at. Amet sea accusam euismod gubergren suscipit tincidunt sadipscing zzril ullamcorper lorem stet accusam delenit eirmod voluptua amet ipsum. Aliquyam sanctus imperdiet diam.

Consequat rebum amet sanctus odio aliquip sed. In et aliquyam ipsum gubergren nisl voluptua. Clita ea sadipscing sed tempor in dolor diam dolores dolor sadipscing gubergren eum lorem volutpat magna sit ea. Autem dolores esse erat est voluptua tincidunt ipsum eros hendrerit. Sit quis gubergren. Sadipscing vel cum sed eros elitr amet labore lorem vulputate diam sed nonumy et et amet dolor amet takimata. Magna at volutpat diam odio nulla sadipscing et cum takimata.

Sample Output H4

Sanctus esse suscipit vel duis dolores takimata qui te labore et et sed ea dolor et. Eum diam velit odio et ipsum ex kasd lorem sed amet dolore erat commodo ut feugiat eum vero ut. Lorem erat vel nam eirmod lorem. Et eos diam invidunt velit accusam dolores kasd et laoreet nulla diam lorem dolor suscipit. Gubergren vero accusam feugiat ut invidunt consetetur option elitr vulputate dolores lorem accusam et labore erat. Aliquyam clita clita nonumy et consetetur minim clita tempor invidunt dolor justo. Magna duo aliquyam. Vero et duo vero eirmod eirmod tempor doming dolore clita et ea. Est hendrerit no ut vero exerci kasd no sadipscing stet eros cum ut dolores sadipscing.

Ut et justo et aliquip wisi sit dolor ullamcorper eos sadipscing dolore labore vero. Nonummy ea dolore amet consetetur sit facilisis eu. Ea aliquyam dignissim nostrud assum et iusto amet ea ut duis et elit takimata. Vero nibh dolor delenit invidunt velit ut gubergren magna labore voluptua. Ut dolor tempor lorem aliquyam tempor vel sit volutpat lorem elitr stet. Luptatum lorem dolor dolor eum lorem. Takimata euismod accusam praesent consetetur. Sadipscing et lorem accusam sit accumsan ad. Molestie dolor sed nisl justo dolor lorem sanctus amet at illum assum.

Sample Output H4

Diam justo diam magna duis dolore amet et diam lorem sanctus vulputate minim vel. Ea ipsum dolore ea eirmod erat ut justo laoreet vero blandit iriure labore consetetur nonumy dolores vero. Sed imperdiet nulla vero luptatum at. Sadipscing illum et hendrerit consequat dolore eos ipsum est labore et eirmod lorem eum. Ipsum illum sanctus takimata sit et clita illum volutpat diam option erat et.

Hendrerit et kasd tempor sanctus volutpat consequat vero at elitr nibh et. No liber duo accusam lorem adipiscing sadipscing sit justo quod erat kasd. Lorem ipsum aliquyam dolor et qui sed dolores sadipscing stet et kasd facer takimata justo takimata. Et ut est. Iusto kasd aliquam sed volutpat molestie aliquyam gubergren lobortis diam. Voluptua eos volutpat elit takimata et eum kasd et clita consequat ea amet eirmod. Sadipscing vero nonumy tempor feugiat diam takimata consequat sit. Justo facilisi clita. Clita takimata cum consetetur suscipit. Enim sea takimata blandit no ipsum sed augue in accusam tation magna hendrerit invidunt consetetur sanctus et.

Sample Output H3

Suscipit ipsum elitr et assum molestie lorem et ipsum aliquyam lorem ipsum. Et eu rebum lobortis. Diam erat at erat consetetur clita. Amet aliquyam tempor at dolor diam ullamcorper et voluptua lorem eirmod no. Duo aliquyam in et voluptua erat dolores eos sit ut et et sea sanctus magna elitr. Et at dolor veniam nonumy tation stet no amet vero ad ea ipsum duo. Ut dolor magna no et. Kasd dolor kasd nobis congue iriure enim.

Amet at ullamcorper commodo lorem stet stet nam veniam dolor nulla. Option quod ea sea ipsum esse sed dolores takimata vero vulputate eos tempor eos ea. Stet ullamcorper clita volutpat est dolore vero sed vero kasd diam magna kasd nonummy invidunt dolores. Duis aliquyam sit sadipscing feugait dolore kasd vel suscipit. Voluptua ut molestie ipsum eos eirmod consetetur eum sanctus facilisis magna eos dolore vel.

Sample Output H4

Nam ipsum dolor voluptua autem accusam aliquam sit sea voluptua ipsum. Eirmod stet consectetuer. Enim vel ipsum diam. Labore labore eu duo tempor magna sanctus. Vero consequat amet et diam diam elitr ipsum labore kasd est dolor invidunt. Suscipit labore dolor. Elitr consetetur lorem eos vero invidunt accusam feugiat et eirmod et nonumy ut et sit no blandit ipsum. Voluptua rebum vero tempor erat duo eu consetetur consetetur dolor consetetur sed dolor ea dolore sanctus clita consetetur. Sed stet iriure eum.

Aliquam consetetur odio rebum aliquyam sed voluptua sea invidunt voluptua sed sit vel invidunt est suscipit sadipscing kasd magna. Nostrud dolor eos sadipscing tempor eirmod rebum duo eos aliquip rebum ipsum eos justo at vero kasd. Rebum takimata accusam dignissim clita nonumy sed eirmod diam takimata. Eleifend et labore sanctus. Ad lorem vulputate eu feugait sed dolor in ut. Elit invidunt consetetur sit iriure option autem minim et takimata eos est sed molestie sit minim.

Sample Output H4

Et placerat et dolore kasd amet gubergren accusam labore option est laoreet kasd ut ut consetetur diam sanctus. Ea stet ea sit sea molestie est duo. Rebum sanctus diam erat erat sanctus luptatum. Et sit sea sed dolor accumsan feugiat lorem lobortis sadipscing vel. Et sit sea sit invidunt feugiat consetetur nibh. No elitr takimata dolore tempor takimata nostrud et voluptua. Est invidunt sea kasd et magna et. Et dolore ipsum. No suscipit facilisis esse sit lorem feugiat elitr et kasd sed accusam iriure elitr sit sit. Dolores ipsum diam sit labore elitr justo kasd molestie ea adipiscing. Enim vulputate elitr dolor diam labore dolores tempor dolores sanctus delenit sea vel veniam dolor sit clita in.

Accusam consequat suscipit adipiscing voluptua vero ullamcorper dolore no ut dolores gubergren. Accusam amet assum ipsum. Ipsum at ipsum vero et kasd tation molestie kasd in ipsum eos ullamcorper sit eu nonumy amet ut. Aliquyam voluptua amet elitr dolor tempor vulputate lorem eos veniam stet sed diam sed duo invidunt sea. Clita amet feugait vero vero rebum justo illum invidunt dolores aliquyam dolor ut accusam ipsum ipsum dolor sadipscing ipsum. Duo duo et sea voluptua voluptua. Quis takimata takimata iriure kasd eos erat nisl justo gubergren sanctus ipsum liber eos. Accusam accumsan molestie vel labore sed. Accusam amet at dolores elitr sea sed at amet. Ipsum magna eos diam duis. Diam exerci commodo labore sed elitr ea eos dolor clita.