> For the complete documentation index, see [llms.txt](https://help.pixfizz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pixfizz.com/products-and-design/sample-templates/canvas-prints.md).

# Canvas Prints

```
<!-- 
  Root element: defines global production settings for this product template.
  - unit="inch"         → all dimensions in this definition are in inches
  - dpi="300"           → target render resolution for production output
  - minimum-dpi="150"   → lowest acceptable image resolution; below this the editor
                          warns the user their photo is too low-quality
  - output="pdf"        → production files are generated as PDF (not JPEG)
-->
<definition unit="inch" dpi="300" minimum-dpi="150" output="pdf">

    <!--
      Layers block: defines named layers that elements in the admin Design Tool
      can be assigned to — works like Photoshop layers.
      
      Visibility options:
        "on"          → visible in the editor AND in production output
        "off"         → hidden everywhere (design aid only, togglable in admin)
        "fulfillment" → hidden in the editor/previews, but included in production files
    -->
    <layers>
        <!-- Scale reference overlay — off by default, can be toggled on in admin for design work -->
        <layer name="scale" visibility="off" />

        <!-- Shadow effects layer — visible to the end user in the editor and on previews -->
        <layer name="shadows" visibility="on" />

        <!-- Grid overlay — off by default, togglable in admin as an alignment aid -->
        <layer name="grid" visibility="off" />

        <!-- Cut marks — hidden from the customer but present in production PDF output -->
        <layer name="cutmarks" visibility="fulfillment" />
    </layers>

    <!--
      SET 1: The main canvas page — this is the actual product the customer designs on.
      
      No grow/min/max/add attributes → single fixed page, no user-added pages.
      No count attribute → this page is counted in the product page total (default).
    -->
    <set>
        <!--
          - type="canvas"    → the page type name; matches the layout assigned in the admin Design Tool
          - bleed="1.25"     → 1.25 inches of bleed on all sides — this is the canvas gallery wrap
                               (the image that wraps around the stretcher frame edges)
          - margin="0"       → explicitly disables the safe-area guide in the editor;
                               without this, the editor would show a dashed inner boundary
          - width="12.5"     → total page width INCLUDING bleed (visible face = 12.5 - 2×1.25 = 10")
          - height="12.5"    → total page height INCLUDING bleed (visible face = 10")
          
          So the finished visible canvas face is 10" × 10", with 1.25" wrapping each side.
        -->
        <page type="canvas" bleed="1.25" margin="0" width="12.5" height="12.5" />
    </set>

    <!--
      SET 2: Hidden preview page — generates the project thumbnail shown in cart,
      saved projects, and order history.
      
      - preview="true"      → this set provides the project preview image
      - fulfillment="false" → excluded from production artwork (not sent to the printer)
      - editor="false"      → hidden from the end user in the Design Tool
      
      This is a standard pattern: a separate, smaller page purely for generating
      a clean thumbnail without bleed or wrap areas.
    -->
    <set preview="true" fulfillment="false" editor="false">
        <!--
          - type="preview"  → the page type name for the preview layout in the admin Design Tool
          - width/height    → 10" × 10" — matches the visible face of the canvas
                              (no bleed needed since this is just a thumbnail)
        -->
        <page type="preview" width="10" height="10" />
    </set> 
</definition>
```
