User Manual Quickstart General Concepts Buyer Side Snippets Engraving Styles and Form Fields Flex Designs Sub Documents Scripting Workflows Editing Workflow Production Workflow Tutorial Videos Frame Features Document Settings Position Image Working with Text Single Line Text Multi Line Text Barcodes Symbols Text On Path Shapes Sub Document Sub Document Selection Fitting Warp Effects Buyer Side Settings Resources Account Portal Style Reference Change Log Known Bugs & Limitations Glossary Acknowledgements Api Reference Authorization Tokens Embedding The Editor Custom Integration Backend Api Price Display

Sub Document

Top Menu Bar

Sub Documents are a concept developed by Printess as an easy way to separate documents into logical portions.
All Sub Document settings are located at the Sub Document feature icon in the top menu bar. When a Sub Document frame is selected, the tab shows the settings for Sub Documents.
A Sub Document is essentially a page from another document within the same Template which is inserted into the actual document like an image. The most powerful feature of a Sub Document is that this document will stay intelligent by reacting to new data and can also have variations.

Sub Documents enable powerful user interfaces which are easy to create. Please learn more about Sub Document concepts here.

Sub Document Selection

Sub Document

Here one can choose which document is displayed in the frame. Essentially every document except the one currently being edited can be chosen as a Sub Document here. By default, the first page of a Sub Document is the page displayed. However, there is an option to select pages from a Sub Document once they are named. For more information, please see below in the Design Selection section.

Fitting

Sub Document Fitting

Fitting a Sub Document into a frame uses the same modes (Fit, Fill, Crop) as fitting an image. Learn more here But there is an additional mode: flex which uses the Flex Features of a document.

Sub Document Fitting

When a Sub Document frame is switched to flex this means that the document size of the inserted document will be changed to the size of the frame. Therefore, all the powerful Flex Features such as Anchor Points, percentages for size and positioning come into play.

Learn more about Flex Designs here.

The Fit Frame to Sub Document button will resize the Frame to fit the entire Sub Document at the current scale.

Crop Sub Document
If you are in Crop Mode you can re-access the crop settings by clicking the Crop Sub Document button.

Focal Point is active in Fill mode and works the same as when fitting images. Learn more about image fitting here

Sub Document Bleed

Sub Document Bleed

There is also the option to define the visible bleed of a sub document. The Bleed amount is measured on the source document. For convenience there are also buttons to set the bleed either to the bleed of the source document, the target document or remove the bleed. Sub Document Bleed is available only under the condition that no effect or warp settings are active for the sub document frame.

Hide Non-Printable Layers in Preview

Hide Non-Printable Layers in Preview

This setting determines if a placed Sub Document should show layers that are set to output on print. Learn more about layer settings here. This is useful if you’d like to provide a product preview somewhere where the product will appear as it will when printed, without showing editor annotations or UI elements.

Show as Form Field

Show as Form Field

Show as Form Field is a very powerful option for Sub Documents. It allows Buyer Side selection of a specific page in the Sub Document. To make this feature work, one needs to give the pages in the Sub Document unique names. Go to the Sub Document Pages tab, click on the small triangle beside a page or right-click on a page to open the Context menu.

Show as Form Field

In the Context menu choose Change Name and enter a unique name for each page (only pages with a name can later be selected).
Now go back to the document where the Sub Document frame is placed, click on it and switch on Show as Form Field. In the document’s Form Field tab on the left, a new form field with a drop-down containing the entered page names will appear.

Stroke Controls

If one changes the form field value, the selected page in the Sub Document frame changes accordingly. As form fields also allow for icon selections on Buyer Side, Sub Documents are a powerful feature to create easy to use user experiences for complex configurations.

Apply Changes To All Instances

Apply Changes To All Instances
If activated, changes made to this intances will also be applied to all other instances of the sub document

Invert on Screen

Apply Changes To All Instances

If activated the content of the subdocument will be inverted on screen only. This feature is useful if one would like to simulate lasering / engraving of the content for preview.

Read more about Buyer Side settings for form fields here.