cloudformatter format requests: 6,170,651    pages delivered: 14,086,049

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

Est dolore kasd odio iriure ipsum duis et nonummy sed. Amet liber clita vulputate sed dolores dolor eirmod sit diam esse wisi dolore. Consetetur eirmod est sea sadipscing. Accusam ut dolores nisl takimata sit ea vero at sed at nulla erat amet. Sanctus qui eos.

Euismod dolor ea stet justo diam kasd sit invidunt lorem exerci rebum. Diam amet ea eirmod diam dolore et volutpat rebum stet liber et. Ipsum dolor sadipscing dolore. Kasd takimata dignissim vulputate vero et lorem elit magna. Volutpat et dolor sit consetetur vero diam lorem sed diam elitr diam consetetur et. Labore diam ipsum sadipscing sanctus sea takimata lorem duis sadipscing sanctus rebum labore. Sed ut euismod amet lorem lorem sadipscing diam justo. Ipsum option commodo et sadipscing consetetur et adipiscing autem. Et sea magna sanctus id dolor te molestie ipsum quod lorem sadipscing est dolor duo lorem. Sed sit eos takimata aliquyam et feugait sed sanctus eu. Veniam diam sit consetetur.

Sample Output H3

Amet dolores elit. At dolor takimata sea. Consetetur dolor diam in sit zzril nonumy clita labore invidunt dolore labore te. Aliquyam consequat ipsum et wisi eos nulla in consetetur no. Sanctus sit sadipscing. Elit eirmod sit lorem quis ex in nulla dolor. Consetetur et vero amet takimata id sea clita option option vero odio vero velit. No consequat takimata. Nonummy vero ipsum nulla tempor sit ipsum sed invidunt labore tempor. Et in suscipit sea aliquam sanctus est clita vel est invidunt dolor in et.

Kasd rebum praesent stet duis gubergren molestie nostrud sit nulla eirmod dolor. Lorem lobortis ipsum minim sadipscing. Aliquyam ut lorem molestie molestie nonummy nam nonumy nibh esse duis tempor ea et nostrud rebum. Aliquip eos facilisi gubergren takimata lorem rebum diam dolores lorem ea erat wisi et ut sit ut et at. Autem rebum duo sed et sea molestie blandit odio takimata augue diam sed. Qui accusam ex tempor eos dolor tempor lobortis volutpat. Sed kasd kasd lorem. Accusam nulla accusam in et elitr tempor est erat eirmod dolore sit euismod takimata facilisis elitr. Eirmod erat et duo aliquyam elitr sadipscing eos amet sed clita sea eirmod kasd ipsum. Aliquyam et vero. Et takimata consetetur dolore dolore takimata eirmod feugait dolore facilisis nobis elitr amet.

Sample Output H4

Magna diam lorem facer eirmod sit et et sit at at elitr diam duo rebum eos et dolor wisi. Magna volutpat dolores consequat vulputate et dolore dolores duo sea accusam. Amet eirmod dolores te diam at dolor amet voluptua duo voluptua diam. Et quis sed amet consetetur dolor diam dolores sed elitr. Diam molestie lorem molestie ipsum ipsum lorem elitr et dolores no nonumy.

Et consetetur eos vero nonumy. No gubergren sadipscing dolore clita iriure eos suscipit quis eos. In dolor takimata accusam tation sed nonumy ipsum nulla rebum labore commodo vero sea odio. Sed et consectetuer in sadipscing ipsum at. No id consetetur laoreet est eros no dolor et. Lorem elitr gubergren aliquip sed lorem sadipscing voluptua nibh duo voluptua tempor et dolore gubergren zzril ea amet. Facer sit exerci. Esse sea clita cum praesent voluptua luptatum amet suscipit gubergren dolore diam sed praesent diam.

Sample Output H4

Elit duo facilisi veniam quod invidunt velit kasd stet diam kasd duis. Consequat accumsan diam eirmod sanctus consetetur vel nonummy gubergren dolore sed duo assum. Et ut aliquyam. At clita nonummy takimata consectetuer sit eros erat accusam eos elitr assum dolore est liber eirmod et. Velit facilisi kasd enim laoreet vulputate takimata invidunt facilisis quod sanctus. Sit eirmod et takimata invidunt sit sed erat voluptua nonumy clita sadipscing justo nihil in accusam ea eos magna. Stet dolore eirmod eos accusam aliquyam nonumy ipsum erat consequat accusam duo vero. Eos eirmod eos erat dignissim est erat te kasd duis nulla duo elitr at stet dolor velit sanctus. Iusto dolore et amet consetetur ut dolore amet eirmod erat duis wisi sadipscing justo tempor tincidunt amet. Invidunt vulputate at accusam ea lorem feugait veniam lorem.

Aliquip et sea. Takimata qui dolor ipsum. Stet sadipscing aliquyam kasd sadipscing lorem tempor sed amet. Est justo tempor sit. Justo invidunt ut et accusam voluptua eu magna magna erat. Sit lorem duis invidunt duo vero dolore dolore volutpat tation. Ea kasd diam no vel vero est amet ad no dolore invidunt. Et dolores at. Clita magna clita diam rebum aliquam. Zzril erat et ex.

Sample Output H3

Vulputate amet elitr elit. In qui diam stet takimata diam accusam dolores et rebum option labore. Sit dolores ipsum justo in et sed sit eos et congue blandit no et duo zzril ut et. Dolor ut vel nisl sed lorem vero sit takimata dolor dolore nulla sit. Adipiscing lorem autem sadipscing iusto gubergren tincidunt ea nisl duo lorem kasd te lorem justo ipsum. Sit nihil dolores amet zzril sanctus kasd stet et et elit iusto lorem at at dolor. Sadipscing vero accusam et dolores takimata dolor amet magna voluptua dolore. Justo sea sit esse gubergren nulla kasd et sed labore. Invidunt rebum sit dolore sadipscing sit autem in diam stet tempor accumsan ipsum et. Labore placerat consequat duis labore.

Et nulla sea accusam et consetetur erat ea rebum nonummy sea. Labore sea rebum stet dolore lorem sit sit sea vel dolor dolore dolor tincidunt clita eum vulputate. Stet sit duis veniam dolore et qui placerat clita aliquip rebum. Erat euismod amet consectetuer ea diam et. Dolor kasd nobis ipsum consectetuer feugiat quis at vero feugiat et nobis sit sea volutpat vero ut. Vero sed te lorem elitr feugiat tempor aliquyam.

Sample Output H4

Aliquip duis nostrud et in gubergren qui invidunt praesent lorem. Blandit sed at volutpat nisl volutpat. Sit feugait sea sadipscing et. Stet nulla dolor eu duo et gubergren nisl enim justo in sit duo clita. Invidunt diam dolore et odio magna. Dolor et ut sea gubergren at eum nibh lorem no diam duo sea clita takimata et volutpat. Nisl lorem lorem at invidunt accusam sit vero eirmod. Et at esse clita gubergren et et dolore voluptua eu gubergren dolore. Eirmod eleifend et duis amet lorem rebum aliquyam duo dolore sed ea vero diam nisl erat molestie eos tempor. Dolore sanctus exerci eos ipsum in eirmod sed velit amet eirmod molestie lorem amet et in lorem facer duis. Vero invidunt dolor sea tation.

Aliquyam sit eos quis nam eos lorem diam. Nonumy sadipscing aliquyam gubergren et erat. Et doming no facilisis luptatum vero stet no consetetur vero amet rebum. Tempor labore esse sanctus sadipscing takimata. Et ex ex nulla sanctus. Gubergren dignissim elit gubergren vulputate lorem dignissim diam et luptatum ipsum dolores dolores sanctus. Ipsum luptatum consequat in molestie dolor amet ut takimata accumsan dolores sea et sed diam amet. Ut amet ut tempor sed illum dolores sit erat.

Sample Output H4

Wisi diam eirmod at dolor ea blandit eirmod duo. Vulputate lorem accusam magna esse tempor eos eum ea invidunt elitr ut lorem clita sit ipsum est et. Et aliquyam est amet diam. Hendrerit consectetuer sed sanctus dolor. Amet sed ullamcorper et sit aliquyam stet diam ea quod duis dolor et. Rebum duis doming vero iusto augue congue sed sit.

At labore no et duo dolore et autem duis eros vero dolore eu. No elitr erat ad. Zzril takimata rebum sit elitr ipsum sed duo nobis eos. Voluptua diam at amet odio. Molestie est et vero vero duis labore eos lorem blandit dolores duo augue et blandit.

More Sample Output H2

Et veniam amet rebum volutpat augue at stet vero at illum adipiscing aliquip. Amet labore esse est vero accusam erat placerat no diam erat sanctus. At adipiscing eirmod. Consetetur ut feugiat eirmod et at diam nonumy diam nobis. Sit feugait lorem vero dolor magna. Labore sed ea consetetur et option velit ipsum est dolor kasd et dolor ipsum invidunt velit. Et vel nonumy vero elitr dolor amet dolor justo et placerat. Accusam vulputate lobortis facilisi ipsum luptatum dolor lorem lorem erat dolores.

Et vero amet qui stet sit ea justo sed. Duo elitr et. Sadipscing ea dolor invidunt amet et ut nisl consetetur et. Amet adipiscing eirmod sit. Invidunt cum augue voluptua laoreet dolor ipsum sit. Ex et congue sadipscing. Dolore option mazim sed lorem nonumy et consetetur commodo. Praesent ut dolore assum adipiscing stet lorem sed justo invidunt est eu nihil at.

Sample Output H3

Consetetur sit dolore labore et sanctus gubergren rebum justo lorem tempor. Vel stet sed sed dolor invidunt assum tempor clita sit dolore consetetur consequat. Dolore sea id dolor ipsum volutpat lorem commodo augue justo. Praesent consequat aliquyam et dolores amet ea qui nulla tempor sanctus clita. Nibh amet suscipit amet nostrud no invidunt dolor liber diam at ipsum blandit blandit dolor gubergren diam duo. Est nonummy lorem ex sea amet consetetur ut ea at et voluptua. Sit illum no ut stet ipsum sadipscing lobortis sit dolor clita te lobortis. Consequat minim stet sea tempor at nisl diam liber gubergren consetetur ipsum est veniam vero sea. Ipsum lorem magna sed est feugait tation autem sit at stet dolor facilisis elitr. Erat in aliquyam nonumy dolor amet. Ipsum praesent vero voluptua enim dolor sed ipsum consequat erat.

At sanctus labore dolore sed sanctus accusam kasd elitr labore. Eum at duo diam tation vel et. Accumsan gubergren dolore. Justo et erat sed erat amet lorem duis. Takimata vero dolor lorem sit ullamcorper justo lorem magna. Et ipsum sea euismod amet consequat sea eos dolore aliquyam clita feugiat autem at et ea et et. Mazim clita nonumy molestie sadipscing takimata dolor dolores diam eos eos ea accusam in est adipiscing sea. Eos feugiat sed et sed in. Invidunt voluptua imperdiet voluptua illum laoreet eum et labore sea consetetur diam kasd ea est. Dolore soluta lorem.

Sample Output H4

Placerat tempor dolor nostrud at eirmod consetetur eos eirmod dolore labore blandit hendrerit ipsum adipiscing vero diam et. Ipsum facilisis invidunt ut kasd at autem amet sit eu exerci vulputate. Nostrud justo dolore. Sanctus dolore consetetur labore amet. Dolor tempor gubergren. Vulputate stet vero in consetetur erat.

Et dignissim ipsum dolore duo eros mazim tempor consetetur amet labore. Sanctus clita accusam feugait et eirmod stet dolore ipsum eu vulputate eos amet consectetuer sadipscing ad diam ut. Tation sit dolores dolore stet invidunt dolor labore ea feugait vero ipsum ut ipsum sanctus. Lorem sadipscing ea gubergren suscipit. Consetetur nihil molestie erat hendrerit aliquyam ex molestie voluptua. No sadipscing id molestie velit in sea suscipit lobortis lorem dolore eros at veniam. Feugiat consetetur nibh et.

Sample Output H4

Vel eum eos takimata molestie. Labore delenit ipsum commodo duo elit sea sadipscing sed tempor justo rebum et invidunt at amet. Nonumy praesent esse eos at clita dolor. Exerci accusam vulputate. Dolore erat feugiat tempor ut eos amet consetetur invidunt. Sed dolores volutpat ea dolor voluptua zzril sanctus eirmod est takimata. Labore takimata ea diam gubergren soluta stet tincidunt euismod dolor accusam erat vero vulputate accusam voluptua eros clita magna. Kasd aliquyam facer odio labore no gubergren diam diam odio dolore dolore elitr justo.

Voluptua duo rebum quis erat amet ipsum delenit dolore et suscipit elit esse esse. Elitr vero commodo consequat iusto et consetetur duo amet nulla invidunt dolor et rebum. Ipsum sea dolor aliquyam ipsum feugait dolore accusam amet exerci sed sed kasd amet eos. Labore esse sed in sea clita nobis ea at erat lorem ea dolores sit. Dolore justo et velit ipsum vero feugait lorem velit. Ipsum ut vero. Voluptua labore eos iriure sed autem elitr ipsum et amet vero sanctus tempor iusto dolore quis.

Sample Output H3

Illum vero clita dolor facilisi sed at odio augue nonumy commodo vel est gubergren vero et amet consetetur. Eirmod takimata consequat erat duo eum et option sed est accusam sanctus ipsum eum ipsum dolore amet et. Id luptatum lorem lobortis justo cum eum elitr amet ipsum. Dolores eos luptatum labore erat minim est sed diam dolore ut ut sit et iriure. Eirmod ut takimata diam ut tempor dolor justo consetetur labore amet. Tation eos lorem kasd ut diam eirmod ipsum vulputate stet volutpat sit duis et. Takimata gubergren at et facilisi dolore dolor diam. Molestie eirmod liber aliquyam no ipsum diam amet. Diam ipsum est takimata.

Eos erat id vero tincidunt consequat at autem tempor lorem diam takimata. Rebum consetetur praesent nulla quis magna sea rebum diam nulla nulla eros eos. Aliquam aliquam justo dolor amet cum praesent sit duis sit no dolor est. Nulla sit magna duo et velit no eirmod sed augue ut id et clita et. Ut invidunt commodo ipsum est erat vel aliquyam diam lorem dolor duo. Et labore diam sadipscing amet eos diam eros diam qui dolor. Diam elitr at tation tincidunt tempor sanctus aliquyam no ea nonumy invidunt sed sed eu labore dolor nulla.

Sample Output H4

Sit takimata kasd stet rebum. Magna eirmod amet euismod eum amet et sanctus sea tempor amet lorem labore. Nulla eirmod at sit kasd et dolore ut consetetur sanctus. Eum lorem lorem eum no aliquyam clita kasd eos vel. Qui commodo ipsum eos invidunt ut et iriure diam dolor consetetur feugiat elitr exerci dolores nibh. Ut et dolor consetetur diam justo lorem stet labore sadipscing et takimata et voluptua. Duo stet et elitr ipsum eirmod lorem consequat invidunt magna et dolore sit est sea. Sadipscing aliquam tincidunt laoreet sea molestie vero dolor erat lorem gubergren dolor sed amet adipiscing. Vulputate ea quis sed. Vero dolor dolore nisl consequat facilisi iriure ut nibh et takimata voluptua tempor.

Facer lorem lorem lorem diam sanctus illum stet sea dolor vero vero invidunt at et. Sea stet duo ut. Doming et mazim amet luptatum vero ipsum vero. Diam diam sed kasd justo dolor sed ipsum facilisi eu eros ipsum lorem nobis no et ut congue liber. Minim vel dolor vero qui consetetur labore duis ipsum tincidunt dolore at aliquyam. Voluptua labore dolore consetetur et justo voluptua clita est est sadipscing lorem facilisi vulputate consequat. Amet consetetur kasd zzril sanctus duis et ipsum sed vero dolores et amet labore duis et rebum delenit. Sea sit sit eos tempor dolores blandit ut.

Sample Output H4

Amet labore et. At eu iusto dolor accumsan dolor eos clita ea soluta ut ut quod duo iusto. Sea takimata diam kasd accumsan sit et stet erat. Molestie invidunt voluptua liber quis dolor dignissim tempor. Et sadipscing justo tation exerci diam wisi lorem euismod.

Dolor consectetuer et at dolor gubergren clita tempor lobortis sit eum et dolores sed duo amet esse. Elitr amet duis eirmod rebum. Duis dolor enim consequat ipsum no sed nonumy congue vero elitr sit et aliquam dolores amet diam. Dolor nibh diam iriure accusam zzril clita dolore aliquyam id consequat facilisi magna nisl voluptua tempor nostrud dolore quis. Dolor congue nonumy tation accusam lorem adipiscing. Eu ea elitr et consetetur illum sed tempor sanctus nonumy accusam ipsum et.