cloudformatter format requests: 1,042,835    pages delivered: 2,735,589

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

Lorem sed suscipit hendrerit et velit in dolore erat. Magna amet eirmod at exerci aliquyam nulla imperdiet vel et euismod est lorem possim. Adipiscing nonummy autem erat amet euismod stet illum sit dolore diam dolores dolore. Ea et ut. Eirmod iusto diam ut sit stet est consetetur lorem diam sit eirmod et sadipscing et elitr ut. Dolor ut nibh et.

Sed no accusam rebum rebum iusto consequat vero nulla est amet dolores sit est feugiat feugiat. Sea labore dignissim enim no et magna sit nulla in sanctus invidunt vel. Minim et wisi dolor tempor kasd ut aliquyam justo. Iriure aliquyam clita elitr ipsum assum eum sit amet. Illum invidunt sit volutpat et. In stet diam. Erat vulputate eos eum sanctus sit et aliquyam gubergren accusam sed nostrud zzril rebum voluptua sed tempor. Dolor accusam sadipscing facilisis accusam vero eos nibh duis ipsum. Sadipscing accusam augue diam tempor diam sit sed labore tempor magna.

Sample Output H3

Dolor stet stet sanctus est et elitr est vulputate dolore kasd et labore labore. Amet esse aliquyam invidunt vero invidunt dolores et et esse at stet sea ut lorem dolore. Aliquam magna amet no duis. Est eos laoreet dolor ipsum nonumy. Odio elit vero ad takimata autem sed takimata no suscipit. Aliquyam sadipscing dolor nibh dolore et erat molestie aliquyam. Wisi dolor diam gubergren et et quod amet volutpat exerci rebum kasd dolor dolores aliquyam euismod laoreet. Nibh no sit enim ea vel erat ex molestie facilisis liber. Erat lorem tincidunt sit diam sit vulputate nam.

Sed nibh tation dolor qui justo nibh dolores consequat hendrerit et. Aliquyam et consetetur dolor esse veniam magna blandit suscipit aliquyam consetetur at euismod amet aliquip diam voluptua et sed. Nibh dolor luptatum nonumy ipsum duo vulputate kasd diam lorem amet stet amet gubergren et duis dolor nonumy. Eos facilisis dolor accusam duo sed sit diam accusam velit tempor nostrud rebum sit eos sea consetetur. Est ipsum odio nonumy et et sanctus congue magna sadipscing labore. Eirmod tempor iusto vero dolor exerci vero magna delenit facilisi ipsum delenit.

Sample Output H4

Accumsan suscipit invidunt elit consetetur et at sit et sed. Et sanctus vel sed diam et facilisis ipsum in congue lorem invidunt. Lorem elit feugiat dolor duo lorem sit takimata ipsum imperdiet dolores diam nostrud. Et vel assum sadipscing laoreet adipiscing dolore erat aliquyam labore gubergren amet diam. Nonumy erat consetetur sadipscing molestie wisi elit diam ipsum vel. Ipsum amet ea option gubergren eros sit tation ea sea accusam eirmod dignissim et vero. Ea elitr feugiat aliquyam elitr. Qui dolore ut nobis mazim gubergren dolor nonumy ut hendrerit sed nobis diam consequat sanctus.

Euismod kasd illum eum et sea eros takimata dignissim dolore eum. In no ad duo eirmod consetetur qui voluptua consetetur ut sed ad eros no erat erat ipsum aliquyam molestie. Elit sed sanctus sed suscipit duis. Et dolor et et nihil erat takimata stet wisi sadipscing sed velit tempor et. Duo dolor elitr nonumy.

Sample Output H4

Sit et et diam dolor lorem aliquam sea ipsum labore erat. Sea et sed sit stet minim amet labore eum diam eirmod hendrerit nulla eu kasd consequat dolore. Dolor ipsum magna diam sadipscing consequat accusam eleifend dolor. Vero eirmod minim ut vulputate ea ea est. Dolore sed delenit consetetur labore at.

Commodo dolore et takimata dolore consetetur eirmod minim voluptua sadipscing magna nonumy quis feugiat adipiscing. Amet doming nonummy stet rebum dolor no kasd takimata tempor. Nonumy in gubergren. Amet eros sed assum illum. Sit vero sadipscing sanctus eum exerci sed. Ea justo commodo dolor nonumy lorem ullamcorper ut esse feugiat duis et sanctus sit sit amet lorem illum. Consetetur magna adipiscing et sed stet eirmod lorem et.

Sample Output H3

Duo sea dolor takimata placerat consectetuer dolores elitr esse. Gubergren rebum lorem lorem eirmod kasd feugiat sit nonumy dolores erat clita kasd dolor et. Takimata vero ut dolores sit duo magna ipsum kasd et accusam ipsum nulla consectetuer. In magna sed labore sit tincidunt et justo dolor takimata invidunt diam sit dolor sanctus ipsum est labore nonumy. Sadipscing takimata diam sadipscing voluptua stet amet tation feugiat diam et duo eum. Accusam magna molestie stet lorem tation vero sit gubergren consetetur ea takimata lorem. Sanctus diam et rebum nonumy takimata ut dolor.

No tempor sed. Ut eum ut duo magna kasd et. Te elitr clita nihil sit in sed gubergren erat molestie gubergren takimata dolor ex ut justo congue accumsan. Justo est velit est duo ut lorem iriure aliquip et sit tempor elitr te eos. Suscipit accusam ut velit voluptua clita praesent molestie nonumy sed ut hendrerit eos eos nonumy. Euismod et sit et sanctus accusam in sed ipsum ea lorem diam.

Sample Output H4

Consectetuer rebum lorem tempor dolore minim accusam amet sed et accusam ipsum labore diam. In et kasd zzril nonummy dolor dolores gubergren. Clita tempor at rebum odio sea sea duis nonumy amet diam possim ipsum aliquip velit. Luptatum dolore duis quod enim ipsum eirmod ex erat sed. Nonumy sea est quod labore. Quis sed dolor ipsum sea dolor accusam enim sea vel aliquyam stet amet ipsum ea nibh sed gubergren clita. Et at no amet gubergren dignissim elitr sadipscing justo lorem labore magna sadipscing ipsum clita rebum kasd ut. Kasd diam voluptua vero accusam eu est labore hendrerit labore nulla. Amet illum sed tempor magna dolore ipsum consetetur ullamcorper et nihil stet velit dolore justo.

Gubergren et et lobortis et ut ea diam dignissim. Sit diam ipsum duo at vero. In diam ipsum lorem dolore. Stet voluptua ipsum diam clita stet lorem sea stet labore at sit sed rebum. Vel clita vel dolor clita stet. Tincidunt justo accusam et dolore. Sadipscing facilisis sed sed aliquyam eirmod ipsum.

Sample Output H4

Stet tempor diam esse consetetur vulputate accusam kasd dolore quis in sea. Sea amet ipsum. Justo amet stet labore duo nonumy takimata aliquam ea labore voluptua ipsum accusam iriure kasd. Diam dolores at justo dolore erat sed lorem no nonumy clita sit exerci lorem vulputate in sea nonummy. Tempor sed labore sit ipsum velit ea aliquyam ipsum sed sit nulla ea amet eirmod dolores consetetur vero. Facilisi justo et dolores vero eu sed kasd sea et feugiat est accusam dolore nonummy tincidunt duis exerci. Diam congue iriure dolor voluptua diam stet sed sit enim aliquam magna mazim ut takimata.

Ea vero voluptua vel odio sed sea delenit. Eos tincidunt est takimata voluptua sea et in dolor dolore diam. Vel sed clita sit magna sit accusam. Vero eirmod vel nobis no feugait voluptua velit erat diam et aliquam nonumy iusto ipsum ullamcorper eos. Esse amet laoreet sit erat est et sit. Amet ea molestie accumsan magna invidunt delenit ipsum labore sadipscing et consequat dolores sanctus nonumy justo. Sit diam in no esse magna clita. Tempor no nulla voluptua nonumy sed est sea sed iusto accusam. Duis est sit sadipscing ut justo rebum sit gubergren diam nonumy dolor magna hendrerit et takimata. Gubergren kasd gubergren erat et eirmod sed eirmod elitr augue rebum duo possim sadipscing gubergren invidunt dolore. Dolor et dolores ut cum sadipscing clita eos nonumy eirmod accumsan et vel takimata ea autem dolore kasd.

More Sample Output H2

Volutpat dolores suscipit voluptua dolore et ea et velit consetetur. Molestie et consequat vero duo diam vero elitr dolores at ut ipsum et adipiscing sit et sea ipsum. Elit est et labore vero erat. Kasd dolor erat in sed ut delenit. Sed elitr sit labore et et ut dignissim consetetur suscipit diam justo sit accumsan rebum. Iriure aliquyam ipsum rebum sit gubergren et eos. Lorem luptatum lorem sit sea sit sadipscing dolor at sed feugait et eos lorem invidunt voluptua vel. Id sit kasd stet accusam ut at ea ipsum consetetur luptatum wisi aliquyam diam. Magna sadipscing eirmod. Iriure ut exerci assum adipiscing. Dolor dignissim sit ea vero clita eros amet stet hendrerit diam.

Rebum dolor lorem nonumy ipsum eirmod amet gubergren gubergren ad sit erat commodo luptatum sit. Tation dolore voluptua clita diam et lorem esse lorem vero dolore vero ea duo liber dolor sed. Vero nulla lorem luptatum. Diam ipsum sit sed eirmod lorem sit feugait. Voluptua takimata eirmod facilisi vel et invidunt amet vero dolores diam vero. Duis augue sadipscing kasd lorem diam imperdiet nulla feugait accumsan consetetur. Invidunt rebum ipsum sed ea dolor dolore ea eirmod ipsum sea aliquyam ipsum clita ea. Nihil ea tempor. Hendrerit vulputate lorem et luptatum diam mazim ullamcorper ipsum odio ex. Consetetur lorem illum sea labore et sed tempor sed gubergren stet quis diam.

Sample Output H3

Tempor sed feugiat amet at accusam dolor duis aliquyam in et elit laoreet vero facilisi dolores enim et. Consequat quis duis kasd. Ea tempor amet consectetuer aliquyam nostrud vulputate. Lorem rebum suscipit et sit te et. Eros tempor nonumy ea labore erat accumsan stet ipsum elitr rebum dolore eos ut duo feugait ea ea rebum. Dolore amet tempor praesent ipsum justo voluptua lobortis justo. Sit sea id sed amet no elitr. Et tincidunt magna tempor dolores eirmod et nonummy sit autem ea sit ipsum ut kasd amet nibh.

Dolore stet magna nonumy et consetetur ad accumsan takimata erat ipsum consectetuer no sit diam volutpat. Consetetur adipiscing sit amet nisl eum consectetuer magna sadipscing eos est eu et nonumy accusam invidunt sed odio. Sit et ea. Ipsum ad voluptua sanctus ipsum clita takimata augue. Dolor magna sanctus sed no duo duo sit delenit ipsum accumsan et no elitr diam diam et sit duo. Diam et et erat takimata commodo aliquip vero molestie.

Sample Output H4

Tempor sed eirmod. Vulputate justo sed sed eos dolor erat suscipit ut facilisi. Amet dolore lorem consequat ea dolores nisl et augue dignissim et. Labore kasd dolore sea amet voluptua eu odio voluptua dolor sit lorem lorem laoreet justo id. Sanctus gubergren esse eos. Ea et dolor sed esse dolor commodo consetetur laoreet gubergren dolore. Te et nostrud magna magna at tincidunt et diam elitr at rebum sadipscing clita sed stet sadipscing facilisi.

Lorem dolore sadipscing amet veniam no nonumy sed vero amet rebum ipsum nulla sed diam ipsum. Iriure no amet dolore lorem invidunt veniam sea ipsum feugiat amet in ut dolor et sit autem gubergren sadipscing. Consetetur illum labore. Magna amet kasd sed facilisi elit dolor illum iriure sed et. Nulla aliquyam sit ea. Elitr amet sed sed nonumy iusto ipsum.

Sample Output H4

Ipsum dolore ipsum aliquyam vero kasd suscipit gubergren dolor sea assum et. Autem ipsum te feugait takimata invidunt ut hendrerit enim sea sadipscing sed. Ea gubergren nostrud sed vero labore ipsum et ea justo dolore rebum eirmod est clita praesent erat sadipscing kasd. Eos consectetuer rebum duo magna et clita amet sadipscing esse vero nostrud accumsan et. Amet et at illum lorem dolore dolor. Sed ad consetetur et ea in voluptua dolor ea dolore diam aliquyam praesent aliquyam id sed. Eos dolor sanctus ut. Lorem sed ea nibh dolores labore justo sadipscing et ea vel aliquip ut. Tempor no nonummy eos duo eirmod sea nonummy labore. Sadipscing ea nisl dolor gubergren eos labore ut nibh. Et lorem aliquam justo accumsan ullamcorper et placerat at at qui.

Et diam at gubergren augue vel in eirmod rebum sed eirmod lorem sit at duo. Sed ea no at nisl ea et et diam autem sadipscing et. Dolor sea eos diam lorem adipiscing sanctus amet accusam. Feugait eirmod dolor in feugiat amet amet esse dolor lorem gubergren. Gubergren nonumy sed in takimata facilisi lorem consequat rebum sit et molestie stet eos ea veniam sit erat. Et takimata rebum amet tempor diam takimata. In iriure kasd aliquyam eos euismod est. Duis ut stet nonummy liber. Ullamcorper nam elitr velit in nulla duo labore esse sed justo sadipscing voluptua accumsan magna. Eirmod magna lorem et dolor eirmod lorem accusam quod clita sea consequat. Eros dolore aliquam justo et sit lorem eros kasd nulla doming justo sanctus.

Sample Output H3

Kasd commodo duis rebum duo labore minim exerci diam eu lorem enim ea tempor dolor adipiscing. Sit consectetuer dolor no justo sed sanctus eos. Dolor accusam nonumy eos laoreet sed ea consequat dolor amet illum augue ea tempor gubergren takimata diam tempor. Duo nonumy in. Lorem eos blandit elitr eros kasd elitr vero nulla in sadipscing kasd te esse sanctus gubergren.

Dolore diam dolor sit no lorem nonumy. Dolor sed aliquip invidunt lorem tempor magna consequat diam option lorem lorem diam tation sit accusam. Eos laoreet accusam ut dolor ut autem. Molestie takimata stet et ipsum rebum rebum stet tincidunt no dolore consequat iusto amet. Labore eos dolor tincidunt sanctus. Minim sed et magna amet invidunt dolore sea ut enim. Gubergren hendrerit sed erat et lorem sed sit vulputate invidunt elit.

Sample Output H4

Justo duo sanctus minim tempor sanctus est aliquyam aliquyam et accusam amet ullamcorper ipsum aliquam sed kasd. Possim no sed facilisis rebum diam diam vel. Sanctus velit amet iriure sed magna eos clita sed autem ut labore. Dolor stet est at ea erat clita sit. Et iriure magna amet sadipscing clita vero ipsum sed sit et takimata lorem vulputate eirmod no sadipscing. Et sed sed rebum dolore invidunt dolor clita erat odio justo sadipscing ipsum eirmod justo. Et sea clita wisi. Kasd ea vero ut consectetuer sit amet ipsum in dolores.

Blandit facilisis quod gubergren no kasd amet eos magna et diam duis tempor ipsum feugiat tempor dolor. Erat ipsum eum zzril velit. Lorem clita volutpat sit sit dolor nam ex. Dolores magna gubergren amet sadipscing. Ut dolores accusam option feugiat amet et amet elitr nonumy stet magna duis tempor tempor enim ipsum vero sit. Ea sadipscing dolore dolores blandit amet. Diam vulputate no laoreet exerci est et vel dolor eos sit. Imperdiet rebum clita laoreet nonumy labore vero takimata ad vel duo rebum ut eum et te et.

Sample Output H4

Sit labore suscipit dolor stet dolor praesent invidunt amet magna tincidunt diam doming sit clita justo veniam ipsum invidunt. Duo diam vulputate eirmod diam et dolor ipsum duo labore elitr sea quis tempor aliquyam sed eirmod. Eirmod vero dolore dolor duis voluptua sadipscing doming eos kasd eos et no. Accusam lobortis duo est delenit invidunt odio in voluptua ea justo et nulla minim nihil. Adipiscing ut ut sit et erat facilisi lorem ad clita nonummy. Dolor qui enim ipsum at sit suscipit takimata justo. Adipiscing dolor in facer dolor dolor erat magna dolor autem dolor et.

Duo augue tempor elitr sit dolore kasd tempor sed takimata feugiat lorem wisi et at facilisi. Placerat aliquyam ipsum labore eirmod dolore commodo diam kasd vero et voluptua ut ea vel eirmod tempor. Sit rebum rebum kasd tempor eos nonumy kasd lorem sea consequat at no eos sed dolores. Consetetur dolore lorem lobortis diam iusto rebum vel sadipscing diam gubergren est. Amet delenit voluptua diam consetetur no dolor illum vel at elitr et.