cloudformatter format requests: 1,209,064    pages delivered: 3,116,264

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

Rebum voluptua euismod. Ea vel te ut volutpat lorem est erat. Justo sed lorem. Diam eos clita esse dolor nonumy. Tempor autem iusto invidunt takimata tempor justo ut adipiscing stet augue lorem hendrerit sit sed tempor et. Ut nonumy et gubergren amet autem invidunt rebum clita nonumy.

Dolore sit diam ipsum laoreet sea no at imperdiet consequat aliquyam odio. Et nonumy liber stet amet sit liber velit clita. Accusam gubergren sed id diam et sadipscing amet feugait sed elitr zzril illum diam sed. Amet diam nulla ea consetetur gubergren sit imperdiet magna takimata lorem sit et et ullamcorper. Tempor clita ut. Stet feugiat dolore elitr cum consectetuer nonumy facilisis eos diam sea erat et et amet erat. Dolor clita erat magna amet quis accusam labore tation ea gubergren nisl ipsum quis justo odio ea magna vulputate. Dolores dolore nibh esse amet vero dolore ipsum invidunt. Consetetur tempor sed erat nonumy sit no consetetur feugiat dolores. Elitr sadipscing et aliquyam consetetur et ullamcorper. Iriure takimata consetetur nonummy cum nulla consectetuer amet ut rebum sadipscing.

Sample Output H3

Eu dolore aliquip eos at. Velit justo magna accusam duis aliquam dolor sadipscing ipsum eum feugait sanctus lorem dolor suscipit. Molestie vel te et est nonumy wisi. Erat possim ea nonumy feugait clita dolor sanctus. Aliquyam ut nonumy clita erat feugiat no ut delenit lorem sit duo sea eirmod amet dolore et sed et. Consequat justo dolor amet delenit sed erat ex sea ea vulputate labore ea. Ut dolores dignissim consequat amet takimata consectetuer lorem placerat sed magna option accusam nobis luptatum et eirmod dolor diam. Dignissim clita justo justo magna elit labore vero congue stet elitr. Consequat tempor delenit labore eum nonumy nonumy stet dolore aliquyam autem vel. Amet accusam exerci ipsum ex illum. Takimata at justo duis ad erat lorem lorem sanctus sit tincidunt sed ad minim.

Dolor luptatum erat blandit vero enim dolore diam dolores vero lobortis dolore quis facilisi et. Dolore invidunt nulla no tempor tempor esse lorem labore in sanctus labore est duo sed et ut molestie. Est dolore stet et kasd et. Kasd takimata diam et diam duo at facilisis sit feugiat magna vulputate aliquyam dolore magna autem. Et nulla dolores justo et dolor erat rebum velit. Et doming et invidunt ipsum et. Sadipscing euismod laoreet stet delenit nam exerci dolor nonumy magna sadipscing sed takimata voluptua diam et ipsum. Ipsum no gubergren consetetur dolore. Sea labore dignissim gubergren aliquyam voluptua gubergren vel nulla. Placerat accusam voluptua volutpat commodo dolor sea. At ea justo.

Sample Output H4

Nam voluptua aliquam est. Ea vero erat. Dolore nonumy est kasd invidunt. Volutpat stet est eum qui labore ea. Eum duis labore dolor amet nonumy.

Erat nonumy diam ea et. Accusam sed ipsum aliquam kasd feugait hendrerit tempor zzril sed et erat eos option eu vero. Autem ipsum vero elitr sea qui augue vero elitr et tempor kasd et accusam accusam. Et sed augue dolore sit facilisi. Eos id sit gubergren. Lorem molestie amet invidunt sanctus ipsum hendrerit. Gubergren duo consetetur et justo sit justo kasd ipsum voluptua ex accusam consetetur ipsum lorem facilisi ea no. Elitr consetetur voluptua et no te voluptua nobis takimata ea vel aliquyam amet dolor kasd accusam.

Sample Output H4

Dolor rebum eirmod aliquam luptatum sed duo wisi eirmod tincidunt et dolore clita magna et suscipit nobis dolores. Duo autem sit. Nibh kasd sit blandit accusam sanctus takimata dolore sed sea quis. Amet erat tempor sit dolor ipsum duis accusam et takimata vulputate lorem et. Nonumy sit iriure.

Duo sit lorem consetetur duis volutpat erat eum no dolore autem dolor consetetur sit sed accusam voluptua ea dolor. Accusam ea tincidunt at lorem hendrerit elitr justo ipsum et kasd accusam elitr invidunt elitr ipsum assum. Vero eros velit clita sea diam et clita duis invidunt et dolor stet ad elitr lorem. Cum possim ut et eos sadipscing kasd rebum consetetur et vero et sea no stet nobis vero vero diam. Illum euismod adipiscing invidunt sadipscing elitr accumsan dolor. Tempor no aliquyam. Labore tation no eos minim amet dolore facilisis ullamcorper ea dignissim duis esse. Facilisis elitr ea nonumy et rebum lorem dolor sed lorem aliquyam minim. Tempor vel dolores takimata diam nostrud magna eos clita est sed aliquyam aliquam sit sadipscing dolor kasd. Molestie aliquyam laoreet. Lorem dolore consequat tempor gubergren amet et dolore lorem elitr dolor liber quis nibh dolor sed erat.

Sample Output H3

Zzril sanctus diam vulputate nonummy esse duo et sanctus illum. Veniam gubergren vero est. Takimata sed ipsum aliquyam invidunt. Diam sit molestie amet dolores amet adipiscing mazim et sit ut vel sanctus sed vel accusam et dolores lorem. Kasd sit magna lorem suscipit sed nulla ipsum eu stet diam et ullamcorper nulla amet eirmod eirmod consetetur. Consequat nostrud illum rebum eos consetetur augue volutpat rebum sed ut. Lobortis dolore clita sit consetetur et eirmod sed eirmod sed euismod gubergren. Vero takimata takimata et tation dolore et voluptua consetetur eum eu ipsum amet sed. Elitr et autem eum consequat vero facer at id clita sanctus labore. Et ut gubergren aliquyam. Vero amet eirmod aliquyam aliquyam accusam elitr dolores illum tation nisl.

Augue clita dolores invidunt amet rebum dolore. Et ut rebum delenit lorem aliquyam ea et gubergren feugiat sit dolores. Tempor dolor et odio. At justo clita. Aliquyam at aliquyam. In est et magna possim rebum autem diam. Kasd vero accumsan labore et nostrud dolor accusam et commodo adipiscing lorem clita accusam qui. Takimata accusam dolor ea eos iusto nonumy nisl elitr imperdiet. Sit erat eirmod sanctus justo tempor invidunt.

Sample Output H4

Dolor odio sed sed dolor placerat diam iriure elit elitr dolor et consectetuer gubergren diam at magna. Duo euismod ut accusam sadipscing liber. Consequat elitr sed aliquyam. Dolores ut magna gubergren dolor lorem ipsum et tincidunt sit diam. Et lorem est exerci eirmod sit sed eos volutpat et. Wisi vero voluptua eu est diam erat eirmod. Dolor et at diam ut et feugiat kasd te ipsum lorem duo lorem. Dolores vero ex elitr dolor sit ipsum ipsum consetetur labore amet dolore tempor. At consetetur et sit duo magna dolor dolore. Lorem ut dolore ea stet iusto justo dolores wisi.

Te praesent est ipsum luptatum tempor. Lorem diam sed lorem et duo takimata consequat consequat consectetuer ipsum lorem dolor tempor. Eirmod consequat option magna dolor justo consetetur voluptua. Ea eos duo lorem sea eirmod dolores nonummy magna ut lorem sanctus autem sadipscing at ipsum. Clita accusam tempor stet wisi eum feugiat eos augue nonumy dolores et diam clita est dolores lobortis sed. Justo sea diam stet veniam sea justo et labore no vero.

Sample Output H4

Duo diam sed eos accusam eirmod dolore ipsum sit voluptua ad lorem justo consetetur diam. Ipsum et at dolore consetetur sed amet ea nibh nonumy est delenit gubergren diam at diam. Vero ipsum sit labore duis consetetur ipsum. Lorem feugiat dolore et rebum aliquyam dolor facilisis no. Sea lorem et lorem nonumy nonumy vel dolor amet consequat aliquip eirmod sanctus zzril justo et amet sed eos. Duo diam ipsum ut iriure dolor sit molestie stet euismod sea labore eleifend vel accusam. Diam no aliquyam. No duo augue et sadipscing gubergren.

Eros sit labore sanctus et liber consectetuer magna id ad ex elitr et takimata illum iusto. Ut takimata diam consetetur lorem vulputate velit iriure nostrud. Option consectetuer illum sit volutpat. Ea voluptua et te dolor euismod amet kasd diam lorem ea diam nonumy eirmod. Ut sanctus ea dolor erat duo sea amet diam ut. Eum facilisi invidunt ut at erat et et nulla aliquyam dolores stet.

More Sample Output H2

Kasd ea esse amet et. Facilisi accumsan et wisi ut eirmod diam ipsum invidunt sanctus ea doming sed elitr. Labore at vero et ut takimata dolor rebum odio sit consetetur nibh et consetetur dolor lorem autem veniam et. Et amet esse diam sanctus. Labore labore sit ea sed labore enim sanctus diam velit stet amet laoreet sanctus aliquyam amet nulla lorem. Kasd justo velit ut odio.

No accusam kasd voluptua. Labore duo amet et duo duis eos kasd kasd stet et accusam erat dolor sit nonumy. Nobis kasd sit vero elitr id accusam aliquyam duis ea autem gubergren voluptua sadipscing iriure dolor duo erat sadipscing. Labore et ad dignissim nonumy tempor ipsum ipsum. Molestie magna ipsum sed consetetur et labore vero dolore. In at at wisi ipsum iriure wisi labore justo est sea stet exerci sea nonumy aliquyam nonummy erat. Ut est dolore duo duis stet ut hendrerit justo magna eos sed nonumy consequat esse magna aliquip no. Ipsum vero tempor molestie erat magna gubergren vero vulputate amet feugiat ea at et takimata diam. Sit sanctus dolore nisl. Ipsum labore invidunt vel et justo sit eirmod ullamcorper suscipit accusam vel no sadipscing. Dolor dolore eirmod duo nonumy zzril clita eirmod et ipsum.

Sample Output H3

Lorem dolor et. Iriure congue diam et est invidunt et sanctus diam eum option. Et amet delenit dolor rebum et justo ea justo delenit volutpat autem diam sit. Autem dolore tempor at invidunt dolore gubergren sadipscing amet justo accusam. Duo adipiscing magna diam quis et eos ea et et clita duo accusam ut nostrud aliquyam. Magna sadipscing eu sea zzril duo lorem ipsum accusam enim at stet magna justo tempor dolor eirmod ut ipsum. Dolor sea eu sit elit option ea diam et aliquam soluta sed stet clita rebum diam et. Qui amet diam ullamcorper accusam magna ipsum dolor justo ea duo ut et duo kasd. No vero consetetur magna dolor amet justo autem dolores et clita labore sit no lorem.

Esse consequat lorem gubergren diam invidunt aliquyam dolor eu magna sit voluptua elit consequat. Erat assum ipsum sed sit dolor et et illum imperdiet et labore nulla rebum dolor sed id. Dolores rebum labore stet eirmod ipsum tempor rebum erat dolores et justo diam. Duo sed molestie dolore kasd. Amet ipsum feugiat rebum consequat dolore ut accusam nisl eirmod diam lorem vero justo augue takimata amet et. Amet esse tempor rebum lorem amet dolore justo hendrerit dolore eum sed vulputate ea dolore. Et consectetuer accusam amet sit dolor amet nibh vero feugait ea stet exerci elitr. Nostrud vulputate sed et vel.

Sample Output H4

Voluptua feugiat at erat rebum nonumy at dolor molestie magna. Eleifend vel at. Eos diam duis ipsum dolore eirmod rebum invidunt lorem nibh dolore accusam duo accumsan lorem lorem. Dolor amet odio. Et iusto tempor elit consequat facilisis eirmod quis justo takimata autem et molestie augue. Iusto vulputate invidunt minim.

Voluptua erat et dolores takimata invidunt sanctus dolore sea gubergren gubergren lorem lorem. Zzril accumsan elitr amet no nibh eros augue molestie consequat sit. Sit minim amet ea sanctus duo takimata sed vel. Est nostrud sea sadipscing ex ut clita ipsum eirmod et facilisis elitr accusam ipsum eos sed. Est aliquip stet eum enim sit diam in sadipscing rebum exerci. Elitr sed voluptua sed diam vel quis. Lorem voluptua diam ea nonumy iriure ut vero lorem eos dolor et magna magna lorem sadipscing. Nulla et erat qui ipsum nisl placerat sit kasd eum nonumy qui ea clita.

Sample Output H4

Lorem takimata erat facilisis diam takimata eos amet dolores. Ut et at dolor nibh eum soluta nulla. Nihil dolor aliquip dolor. Duo erat sed rebum sit diam nonumy consetetur amet ipsum kasd diam vero. Ipsum qui amet sed molestie lorem dolor dolore takimata molestie. Veniam sit et stet adipiscing duo accusam consetetur veniam aliquyam sed erat sea tempor clita dolore amet praesent. Aliquyam hendrerit justo nonumy sit lorem ipsum facilisi rebum dolor ut tincidunt clita at clita luptatum. Est magna consequat et sed et clita et voluptua facer sed sed diam et et eos at. Nulla iriure clita et sed stet sed ullamcorper dolor diam. Et ipsum aliquyam aliquyam hendrerit sadipscing rebum dolor.

Gubergren sanctus sanctus. Sea sanctus ut at magna gubergren qui invidunt vel et accusam sed dolore amet clita. Cum et invidunt enim kasd amet. Vel dolore eos kasd ipsum sed qui accusam possim. Erat nonumy rebum rebum vel et amet et autem tempor aliquyam duo commodo.

Sample Output H3

Takimata ut lorem gubergren ipsum sed sed takimata voluptua. Elitr sea dolores rebum amet et facilisis. Dignissim sit dolor erat molestie et et lobortis adipiscing magna molestie amet invidunt. Clita clita dolore sanctus et quis stet aliquyam amet et. Sit vulputate sea et justo diam tempor esse dolores magna rebum est no magna eirmod at autem at. Vulputate consetetur erat sea. Tempor lorem nonumy amet tempor aliquyam in illum voluptua sadipscing lobortis ex takimata dolore duis consetetur dolor. Duo erat ipsum. Diam id et autem laoreet ut. Diam nostrud et stet clita dolor possim ipsum et dolore eirmod. Aliquyam erat dolor voluptua et vulputate sit sit ut sed.

Hendrerit lorem stet nulla. Et in et est tempor. Zzril eu tempor consequat vero eos sit voluptua blandit. No dolores augue invidunt wisi labore et sed ut. Et labore clita dignissim delenit illum aliquyam lorem. In magna lobortis diam duis et rebum nonummy diam eirmod sed magna aliquip. Lorem et magna labore ea kasd amet. Amet lorem facer et magna volutpat sit autem exerci sadipscing elitr exerci vero dolore eos diam sit.

Sample Output H4

Accusam accusam eirmod eos sea amet dolor feugiat ipsum praesent amet nonummy sadipscing. Qui magna consequat sanctus clita facilisi eros sit elitr autem invidunt eu. Dolor et sed. Et ea est nihil dolor sed eu consectetuer esse diam nonumy vel ea sea magna lorem et eos. Eos blandit nonumy vel clita sed rebum exerci eirmod consetetur takimata. Veniam sadipscing nonummy labore nulla eirmod nonumy eu. Labore eos sit ad assum et sed facer. Consequat accusam ipsum molestie liber takimata consetetur duo. Sanctus velit sit.

Sed tempor sadipscing eos nisl vero consequat clita et vulputate clita nonumy consetetur diam ea sadipscing elitr. Dolores et gubergren invidunt invidunt aliquyam eirmod et nonumy imperdiet amet nobis sadipscing sit diam ut labore eu amet. Nonumy ad eos et eirmod takimata erat minim stet dolores lorem dolore enim sit consequat et sed et dolor. Dolor vulputate ut lorem et eleifend vel clita adipiscing sadipscing tincidunt ex ea dolore minim clita. Tation congue ut nibh takimata vulputate eos eum amet eirmod et lorem sadipscing dolor. Consectetuer ea eum dolor dolor duo liber voluptua amet at magna. Takimata duo ex diam et esse justo dolor kasd lorem erat sed duis imperdiet at hendrerit.

Sample Output H4

Adipiscing sanctus dolor ut et amet sea facilisis justo elitr dolor et accusam consequat. Tempor elit voluptua hendrerit at lorem rebum vero dolor eos et sanctus ea diam justo no. In eos stet voluptua dolor nonumy sit nisl takimata et stet imperdiet dolor justo sed accusam et sadipscing. Cum duis nonumy ipsum eu. Lorem invidunt eirmod accusam sadipscing ut. Et invidunt amet congue labore. Dolor autem augue. Duo diam consequat sit sit stet sanctus elitr amet ipsum liber est eirmod velit dignissim.

Ipsum dolore sea eu rebum ipsum sadipscing ad et lorem commodo dolore accusam. Invidunt est vero. Voluptua magna est ipsum dolor et autem ipsum facilisis gubergren sea et consetetur consetetur laoreet vulputate dolore no. Ullamcorper ipsum vero sed dolore ut gubergren et nostrud et takimata et amet. Erat facilisis ex. Lorem consetetur at. Amet amet voluptua.