cloudformatter format requests: 6,170,316    pages delivered: 14,085,434

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

Magna voluptua magna iriure amet et takimata. Id et erat. Ipsum eros nulla. Eirmod elitr sed est et doming nonumy rebum ipsum sanctus sea. Aliquam eleifend nostrud clita labore magna vero consequat. No amet et exerci ut dolor voluptua diam erat aliquyam dignissim ea amet lorem sed justo invidunt diam. Eirmod amet mazim suscipit dolores nam iriure sadipscing sanctus. Rebum et stet voluptua aliquyam eos elitr elitr sed amet dolores clita ut. Elitr sanctus erat vero praesent. Duo magna molestie. Amet delenit dolores diam dolor sanctus.

Accusam veniam no ipsum eirmod nonumy. At vulputate kasd. Elitr dolor sed gubergren adipiscing ut kasd labore et sea at gubergren et aliquyam aliquip rebum minim takimata ea. Eos ut duo sed vero duis at eos. Sadipscing sed sea takimata takimata amet. Ut dolor duo. Tincidunt accusam eros tation amet consetetur dolor duo dolore. Et qui laoreet nonumy sit amet ut duo invidunt et lorem eirmod tempor voluptua justo sit diam gubergren. Dolor nulla diam diam est dolores sit et diam amet minim et sed sed nisl vero eos. Dolor est iriure dolore illum cum sit diam. Labore adipiscing nonumy consetetur dolores accusam labore kasd aliquyam at.

Sample Output H3

Eirmod lorem labore et et in magna consetetur vel commodo sit sit justo at. Vero ipsum aliquyam elitr consetetur enim duis duo amet hendrerit dolor. Dolor amet no sea ea nulla sit rebum est doming. Clita et at ea lorem. Illum eros at elitr dolore no clita amet lorem dignissim. Sanctus dolore duo invidunt accusam. Aliquyam amet eirmod eirmod.

Sanctus consetetur autem erat delenit. Tempor molestie amet. Eirmod consequat at voluptua ut. Ea ipsum kasd qui sanctus suscipit facilisis accumsan eros lorem et at sea ea. Et dolores takimata. Luptatum erat magna. Eirmod vulputate lorem hendrerit doming dolore diam sea amet ipsum odio magna in diam augue. Et duo diam tempor te elitr duo vel labore amet et consequat accusam sed nonumy ut eirmod ea duis.

Sample Output H4

Facilisis magna sed invidunt amet commodo sanctus facer et at sanctus in amet praesent delenit vel consetetur lorem takimata. Vero takimata duis et ipsum tempor lorem aliquyam amet at voluptua. Vel sanctus in tempor ipsum sit minim vero clita lorem consectetuer. Kasd amet voluptua suscipit no eos sadipscing. Velit nulla commodo accusam amet voluptua accusam nulla autem eros in hendrerit dolore laoreet dolor diam at vero. Ipsum at stet kasd et sanctus. Est sea clita rebum. Diam ipsum dolores no diam. Vel odio eos vel et sit et vel magna tation et sadipscing invidunt. Feugiat at autem labore sed dolore dolore luptatum. Et duis adipiscing magna et no invidunt ea dolore voluptua velit sed sanctus at.

Stet sed tempor sea est ut luptatum voluptua ad sadipscing ipsum sea et praesent erat takimata et labore. Magna no invidunt option justo kasd sadipscing stet sit dolore dolor et eirmod eos magna rebum at erat takimata. Ut clita liber consequat. Sed sea adipiscing labore sit et et vulputate et. Nostrud voluptua gubergren duo dolor sanctus sed et sadipscing at. Ipsum invidunt dolor lorem tation kasd sit consequat duo. Lorem volutpat ipsum sed labore nulla eirmod lorem accusam clita ut quis ea diam tempor aliquyam gubergren no lobortis. Consequat clita takimata amet sea vero euismod aliquyam exerci duo no sea est laoreet vero.

Sample Output H4

Diam rebum ad iriure aliquyam sanctus eirmod minim sanctus sanctus amet et. Magna diam at feugiat facer quis sit sea nobis sed sit. Sit lorem kasd sed odio diam ad dolor mazim eu amet diam tation duo nam. Ipsum dolor justo sit feugiat magna ipsum in et vero magna eos sed. Consetetur aliquip feugiat tempor et sit doming ipsum facer sed et. Et eirmod sed labore sanctus et lorem at at est takimata sanctus dolor ea nonumy. Dolore sed amet dolore justo amet et. Consetetur vero ut justo at autem accumsan et voluptua sit dolor no labore consectetuer dolores. Sed ipsum et nonumy aliquyam.

Dolor vel sed sed sea dolore eirmod. Nonumy sit dolore feugait et accusam ut et et aliquyam sit veniam eirmod dolores et. Ipsum nulla invidunt tempor et vero amet erat et enim et. Labore est eu kasd stet sit sea consetetur justo eos ut eirmod. Esse esse no sit nonumy feugiat molestie ipsum sanctus eum erat dolor sit dolor.

Sample Output H3

Invidunt et diam tempor vel lorem sed lorem eos diam eirmod gubergren ut ut at facilisis dolor minim doming. Tincidunt labore nonumy invidunt dolores lorem vel nulla molestie ea stet sadipscing. Elitr et enim magna dolor nonummy eos dolore gubergren lobortis dolor sed dolore. Et volutpat volutpat et ullamcorper tincidunt magna duis duo dolores ipsum assum sed consequat et. No takimata consetetur ipsum veniam aliquam tempor rebum sit dolore et accumsan. Amet eirmod consetetur in lorem ut stet et ipsum rebum.

Sit elit et nihil illum diam molestie no ea congue amet magna voluptua velit et sed qui justo. Dolor placerat dolore takimata ipsum sea kasd at. Ipsum gubergren kasd et. Elitr zzril ut kasd ut elit. Justo eu ea dolor elitr clita suscipit ipsum sed accusam labore. At invidunt lorem ea elitr duo nonumy ut clita diam gubergren diam vulputate lorem voluptua stet no illum no. Est kasd dolore stet dolores no eos imperdiet invidunt diam sit. At dolore duo aliquip lorem eleifend sadipscing sadipscing stet rebum nobis hendrerit.

Sample Output H4

Sed aliquam erat. Sanctus in eros dolore takimata stet eirmod at magna dolore. Dolore erat invidunt vero commodo rebum est et facer no eros lorem et diam elitr at ut duis. Option duo vero eu et. Est consetetur takimata eirmod sit ipsum ipsum kasd autem magna ex feugiat erat accusam kasd et diam magna. Consequat sit sanctus quis sit lorem erat stet nonumy sit dolore amet eum. Erat hendrerit accusam dolor dolore diam. Ut iriure aliquam justo et.

Placerat magna eros magna dolor duo mazim. Adipiscing nobis accumsan et accusam molestie stet diam tempor et takimata et in sit dolore voluptua accusam. Lorem diam takimata. Vulputate kasd iriure diam accusam no at veniam sea sanctus sed. Sea assum takimata dolore.

Sample Output H4

Consetetur ut vel tempor luptatum sit et sit vero et gubergren ipsum magna. Eirmod et gubergren clita gubergren dolore amet et qui diam at at te facilisi. Invidunt tempor et justo sea erat est et tempor rebum doming sanctus. Labore no et est illum eirmod amet eros at dolor accusam in ut dignissim ut erat kasd. Tempor dolore laoreet eirmod dolor. Commodo lobortis eos labore. Vero dolores rebum et labore velit te dignissim dignissim kasd accusam exerci at nibh.

Labore takimata no takimata ut consetetur quis no aliquyam nisl nulla facilisis dolore laoreet eos molestie clita. Nonumy diam takimata stet amet et accusam in vero nam lorem labore stet. Aliquip consequat quis luptatum no dolor nibh. Takimata tincidunt dolor. Vero et sit aliquyam eum sanctus ea dolor labore nobis consetetur. Laoreet consetetur vel stet et lorem gubergren clita.

More Sample Output H2

At dolor clita takimata et invidunt zzril takimata ipsum dolor et amet elitr lorem est amet stet sadipscing ipsum. No lorem nibh sea at tempor no ad gubergren. Augue labore no sanctus diam placerat duo invidunt ipsum nihil molestie stet eos voluptua facer sed sit consetetur takimata. Sed duo sadipscing gubergren vero et esse est et et. Et lorem amet eirmod dolore sed et nobis et diam dolore diam ipsum elitr sit sanctus. Esse labore justo ea te molestie stet. Sed ipsum dolor dolor dolor rebum ipsum. Lorem tempor vel dolore eirmod no amet ex clita facilisi dolores aliquyam diam nonumy duo dolore.

Lorem ipsum eu erat. Ea lorem diam sed sadipscing eos eirmod illum rebum voluptua odio. Sanctus autem accumsan vero diam labore justo consequat duo et et dolore ipsum. Dolore dolor ea vel lorem liber sed rebum dolore sed kasd ut sed diam aliquyam amet tempor molestie diam. Adipiscing nobis voluptua kasd gubergren. Facilisis diam iusto wisi accusam. Accusam stet elitr dolor et justo et sit amet elitr ad eum et. Diam quis lorem. Illum et minim lorem ut ea gubergren ipsum ut. Sed ipsum nostrud esse takimata ut diam nulla dolore dolore. Dolores ea sanctus feugait nonumy labore.

Sample Output H3

Dolores eirmod tempor erat magna ut et ea dolore kasd te accusam duis ut. Sadipscing erat dolore magna eirmod dolore et justo at eos sed ad enim. Sed tempor delenit ea quod vel ut et clita diam sit et. Gubergren clita et elit ut et et eum dolor. Dolor takimata sit eirmod sit sed stet ipsum facer erat nulla erat eirmod. Et et ut. Dignissim ut justo rebum.

Tempor eos consequat sanctus duis magna dolore. Sed invidunt at elitr vel consequat rebum doming. Voluptua gubergren tempor gubergren stet vero facilisis sea dolore ipsum molestie voluptua sanctus duo. Sit amet dolor enim. Dignissim nulla gubergren rebum et ut dolor accusam rebum diam. Ut no tempor sit ipsum ea odio. Lorem dignissim ipsum magna consequat ad vel dolor justo ut sed consequat autem et dolore.

Sample Output H4

Consectetuer vero diam aliquyam eos hendrerit. At diam lorem dolores vero accusam invidunt volutpat nihil at. Sea ad sed te et et et gubergren ut placerat elitr. Amet diam at aliquyam invidunt dolor consetetur diam diam stet diam liber voluptua sit dolore. Eu ipsum accumsan lorem dolore ipsum at magna accumsan diam facilisis diam stet nonumy tation ipsum dolore et. Laoreet amet elitr illum esse lorem sit esse iriure invidunt vulputate. Et et est wisi tempor et sadipscing veniam ipsum dolor amet ut.

Duo consequat eirmod et at aliquam aliquyam sit sadipscing iriure facer lorem ut delenit. Lorem stet vulputate et. Kasd dolor facilisi sanctus accusam et nonumy vero dolor et. Ipsum tation et dolore tempor nobis takimata ipsum duo labore ipsum vero kasd sed accusam. Dolor facilisis ipsum et diam. Feugait vero vero at magna tempor et autem ea dolores. Exerci lorem in amet sanctus ad luptatum eos elitr et dolor stet. Consequat sed ea sanctus veniam consetetur lobortis et dolores sit rebum autem aliquyam. Ut ipsum vero et ipsum magna ut odio at magna eos. Et amet sit duis euismod et clita duo sit lorem molestie lorem voluptua accusam stet iusto facer.

Sample Output H4

Eirmod et ipsum. Ipsum ea amet amet. Nisl voluptua ipsum duo vero voluptua facilisis est amet in in tation dolore kasd ea. Dolores diam ipsum et dolores eos. Dolores est consetetur ut rebum ipsum magna magna nibh elitr delenit et magna sit tempor voluptua erat et no. Amet ipsum vulputate eos eirmod tempor dolores ipsum tempor dolor sit ipsum et amet invidunt. Stet in duis vel ut no gubergren et et clita duis erat stet dolor et sanctus. Diam magna option consectetuer accusam ipsum diam dolore erat kasd autem sed et sed laoreet ea vero stet. Tation vero tempor sed in accusam ipsum sed sadipscing tempor justo invidunt. Consetetur accusam sit stet. Minim sed hendrerit eos dolores sanctus ipsum clita elitr ipsum qui tempor ea et nonumy.

Invidunt nonumy diam vero zzril invidunt facilisi dolores et nonumy voluptua et aliquyam gubergren et. Sadipscing nibh et ea eirmod accumsan. Sadipscing facilisis sed eleifend dolore sanctus sanctus adipiscing dolor kasd delenit lorem accusam. Illum dolor et invidunt liber. Et eos sed amet sadipscing lorem gubergren accusam sadipscing duo magna sadipscing eu eum. Amet consequat invidunt dolore. Euismod diam sed et ut accumsan eros lorem magna autem et facilisis.

Sample Output H3

Ipsum et iusto labore nam eirmod dolor esse sanctus aliquyam esse ut at dolor at. Et dolor ipsum voluptua suscipit eros consetetur ipsum ipsum tempor diam est nulla. Dignissim dolor gubergren eos amet at in cum lorem iriure labore consetetur duo lorem nonumy kasd ea. Sed consetetur velit quis. Euismod eu erat takimata tempor ex justo amet sea voluptua. Feugiat et aliquyam consequat ipsum dolore sit vero laoreet. Elitr ea tempor amet ipsum ipsum iusto ipsum diam delenit tincidunt sanctus nostrud.

Sed in lorem lorem sit justo at sit eos in. Duis stet voluptua feugiat lorem et sed. Amet duo erat no nisl dolores delenit sit aliquyam et dolores dolore vero sit sed magna. Quis sed nulla et dolores rebum lobortis. Suscipit tempor gubergren et dolore ut duo ea accusam justo sed.

Sample Output H4

Vel dolore ea eos consetetur accusam sanctus justo ea diam ut facilisis invidunt nam dolor sed. Volutpat lorem at in ipsum aliquyam est accumsan aliquam rebum ipsum iusto cum voluptua aliquip justo. Facilisis sit diam amet et sadipscing vel tempor no praesent. Consetetur eum no et duo no dolor diam tempor dolores duis consequat amet dolores vel. Takimata dolore erat clita ea sed sit sadipscing sit dignissim et autem kasd sit accusam. Feugiat rebum elit voluptua est diam esse vel at sit dolore tempor aliquyam sed commodo ut. Tempor sanctus takimata duis diam voluptua elit sadipscing dolores accusam. Clita at tempor at sit quod est illum invidunt duo ut erat vero. Tempor ipsum dolor no clita. Ipsum sed lorem vero in ipsum vero voluptua eirmod dolor. Esse takimata elitr.

At takimata vero est eos accusam zzril. Et voluptua nulla ullamcorper ipsum nostrud lorem clita eirmod nihil sed labore facilisis justo ipsum ipsum dolore. Sadipscing diam molestie eum et justo diam lobortis eos. Nonumy facilisis duo dolore magna accusam. Delenit justo dolor eos sadipscing sed et. Nonumy stet augue et est lorem autem et et clita nibh. Vero lorem erat aliquam ut possim facilisis sed.

Sample Output H4

Sit molestie ut ea nonumy et nulla takimata lorem iriure rebum sed vero. Kasd aliquyam duo justo consetetur dolor facilisis et ipsum sadipscing stet eros. Nobis sanctus ipsum option rebum iusto ipsum. At ex feugait ea ea no esse stet vel labore. Diam vero no diam et no consequat gubergren. Et et ad sit.

Rebum dolor sit magna ea diam erat justo esse id. Lorem facilisis elitr sed at takimata in dolor dolore. Iriure lorem ex ipsum dolores kasd. Consetetur sadipscing sed. Dolor vero nonummy labore commodo nobis ut et eos sanctus in in iriure sanctus illum dolores clita. At vel amet. Eos ipsum rebum veniam nostrud rebum at labore in mazim ipsum. Dolor tempor erat takimata magna at sea diam dolore euismod amet gubergren. Illum nobis consetetur et takimata duo diam. Laoreet justo sed justo tempor elitr odio nonummy commodo dolore amet no consetetur diam feugiat ut est et illum. Eos stet aliquyam lorem.