User Manual Quickstart General Concepts 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 Hide Non-Printable Layers in Preview Show as Form Field Warp Effects Buyer Side Settings Resources Style Reference Change Log Glossary Acknowledgements Api Reference Authorization Iframe Api Js Api Backend Api

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 see the Sub Document concepts section for more information on where to use Sub Documents.

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. But there is an additional mode: Native which uses the Flex Features of a document.

When a Sub Document frame is switched to Native 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. Make yourself familiar with Flex Designs in this chapter.

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.

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. See layer settings to learn more. 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.

Read more about Buyer Side settings for form fields here.