# XML Page Parameters

<pre class="language-xml"><code class="lang-xml"><strong>// sample code for a book cover
</strong><strong>&#x3C;page type="cover" position="left-right" width="19.5" height="13.5" hinge="0.4" bleed="0.75" margin="0.5" snap="0,0.525,0.725,1.125">
</strong>    &#x3C;filter type="binding" map="binding" /> 
&#x3C;/page>
</code></pre>

* `type` - Refers to the name of the Page in the Design
* `position` - Allows page captions to be visible on the left and right on a single page spread or cover.
* `width` - Pre-trimmed width of the production file. Any bleed value will **not** be added on top of this value.
* `height` - Pre-trimmed height of the production file. Any bleed value will **not** be added on top of this value.
* `output-name` - The output-name parameter allows you to define not only the 'type name' of the production file, but also allows you to decide how the production PDFs are grouped together. For example, by default similarly sized pages will be grouped in a single multi-page PDF, but you can group any pages you want together by having the same 'output-name'.
* `hinge` - Only usable with a binding map for a cover spine and provides the user with a visible hinge, common on a hard cover, which also moves the center point for the alignment aides.
* `bleed` - Simply a virtual bleed that displays to users within the Design Tool to show them where they can expect the page to be trimmed. This value has no influence of the size of the artwork output size. You can also apply **asymmetrical** bleed values using the following format: top, bottom, left, and right values e.g. `bleed="10 20 10 25"`
* `margin` - Allows you to display a visual safe line to end users. The value is added on top of any bleed value, not from the edge of the page.
* `snap` - Allows you to set custom snap points for alignment aides. By default and if no snap values are added, elements will snap to the edge of the page and the center, both horizontally and vertically. If there is a bleed value set and no margin, the snap point will be the bleed. If there is a margin value set, the snap point will ignore the bleed and instead use the margin. If any snap values are defined, elements will snap exclusively to the values defined. Multiple values must be seperated with a comma.
* `gutter` - Allows a gutter value to be set on internal pages, hiding artwork to the end user in the Design Tool in between the pages to avoid unwanted loss of content within the gutter.

#### Growing Spines

```
<filter type="binding" map="binding" /> 
```

The binding filter can be nested within a page in order to allow for a growing spine in the center of the cover. A map of the spine size needs to be specified within the XML definition based on the range of pages within the book. See example below.

```
<map name="binding">
    <val key="8..44">0.375</val>
    <val key="46..132">0.575</val>
    <val key="134..192">0.775</val>
    <val key="194..240">0.975</val>
</map>
```

#### Layflat Spread Page Break

Nesting the below code within a page will add a line down the center of a spread providing a visual guide, as well as activating the alignment aides center points to work within those quadrants.

```
<filter type="binding-layflat" />
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pixfizz.com/products-and-design/how-to-create-templates/xml-page-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.