In the Online Designer, the primary way to build out a template is to start with either an Adobe Photoshop or InDesign file. While it's possible to simply upload either a Photoshop (PSD) or InDesign (IDML) file, the Online Designer supports an extensive set of markers that can be used within the PSD or IDML to define functionality within the Online Designer. For example, you can set certain elements to be locked, or to allow an image to be swapped out, or how text should behave when edited, or if an element is visible only on the editor canvas and not the output.
Using Markers
Markers are essentially a set of tags that you add to a layer name in a PSD file or an element name in an IDML file. The Online Designer will use these to manage what can be done with that specific design element. Markers follow a very basic syntax.
Each marker is enclosed in a set of angle brackets <...> and inside is an abbreviated name for the marker (usually in uppercase) and a value for the marker (usually in lowercase) separated by an underscore. If there is no value defined, then the default value for that marker is used. While markers are case insensitive, we recommend using the pattern described above for enhanced readability. The first letter of the marker typically indicates the group it's associated with.
NOTE: Markers apply ONLY to the layer or element to which they're added.
Different groups of markers categorize their general functionality. Some markers may be limited depending on the editor mode. For example, Manipulation markers are largely restricted to use with the editor in Advanced mode and will not be available with the editor in Basic mode. The editor mode is configured in the Design Editor Preset assigned to the product in question.
The groups of markers are:
- Manipulations
- Visualization
- Text
- Shapes
- Layers
- Predefined Values
- Images
- Image Placeholders
- Barcode Placeholders
- Object Inspector
- Product Themes
- Spot Channels
- Miscellaneous
- Shortcuts
Manipulations
Manipulations are things that can be done in the designer such as deleting, moving, and rotation.
NOTE: These behaviors are only applicable if the editor is in Advanced mode.
Marker | Type | Default Value | Description |
---|---|---|---|
<MAD> | True or False | t | Allows Deleting By default, users can delete any element on the canvas when in advanced edit mode. To remove the Delete command from the editor menu for the element, add the <MAD_f> marker. |
<MADND> | True or False | t | Allows Drag-N-Drop By default, the editor enables the drag-and-drop mode for image placeholders when you specify the <PH><MAMH_f><MAMV_f> markers. For this marker combination, adding <MADND_f> marker disables dragging the content of placeholders. |
<MAMH> | True or False | t | Allows Move Horizontal By default, the editor allows horizontal moves of design elements. To disable horizontal moves add the <MAMH_f> marker. |
<MAMV> | True or False | t | Allows Move Vertical By default, the editor allows vertical moves of design elements. To disable vertical moves add the <MAMV_f> marker. |
<MAR> | True or False | t | Allows Rotation By default, the editor allows rotation of design elements. To disable rotation add the <MAR_t> marker. |
<MRC> | Value Set | N/A | Resize Corner Defines how corner grips resize design elements.
By default, all design elements have corner grips on bounding rectangles allowing the element to be resized proportionately. Using this tag, you can define the behavior, first, for normal dragging of corner grips and second, for dragging of corner grips while holding down the Shift key. Example: <MRC_pa> Sets the first behavior to be proportional, and the second behavior with the Shift key pressed to be arbitrary. To disable corner grips add the <MRC> marker. |
<MRE> | True or False | t | Resize Edge By default, only rich formatted text and image placeholders can be arbitrarily resized. To enable edge grips on bounding rectangles to allow arbitrary resizing of elements add the <MRE_t> marker. |
Visualization
Visualizations control the visibility of design elements in the editor canvas and on the output.
Marker | Type | Default Value | Description |
---|---|---|---|
<VNP> | True or False | t | No Print By default, the editor shows all design elements on the canvas and output proof and hi-res images. To only show an element on the canvas, add the <VNP> or <VNP_t> marker. |
<VNS> | True or False | t | No Show By default, the editor shows all design elements on the canvas and output proof and hi-res images. To only show an element on the output, add the <VNS> or <VNS_t> marker. |
Text
Text markers are used to control the behavior of text elements in the editor canvas.
Marker | Type | Default Value | Description |
---|---|---|---|
<AST> | True or False | t | Automatically Scales Text Applies ONLY to PSD templates By default, you can resize point text only proportionately. To allow disproportionate scaling of point text to fit the bounding rectangle add the <AST> or <AST_t> marker. |
<RT> | Value | true | Rich Text Defines how paragraph text and text frames appear.
|
<TACA> | True or False | t | Allows Change Alignment By default, the horizontal text alignment buttons are enabled in the editor for point text elements. To disable these for a point text element, add the <TACA_f> marker. If the Design Editor Preset has the horizontal text alignment buttons disabled, then this marker has no effect. |
<TACBIU> | True or False | t | Allows Change Bold Italic Underline By default, the faux bold, faux italic, and underline buttons are enabled in the editor for point text elements. To disable these for a point text element, add the tag <TACBIU_f> marker. If the Design Editor Preset has the text emphasis buttons disabled, this marker has no effect. |
<TACF> | True or False | t | Allows Change Font By default, the font and font style can be changed for point text elements. To disable the Font Name and Font Style lists in the editor toolbar for a point text element, add the <TACF_f> marker. If the Design Editor Preset has the font and font style buttons disabled, this marker has no effect. |
<TACFC> | True or False | t | Allows Change Font Color By default, the font color can be changed for point text elements. To disable the font color picker in the editor toolbar for a point text element, add the <TACFC_f> marker. If the Design Editor Preset has the font color picker disabled, this marker has no effect. |
<TACFS> | True or False | t | Allows Change Font Size By default, the font size can be changed for point text elements. To disable the font size selector in the editor toolbar for a point text element, add the <TACFFS_f> marker. If the Design Editor Preset has the font size selector disabled, this marker has no effect. |
<TACT> | True or False | t | Allows Change Text By default, the content of both bounded and point text elements can be changed. To disable changing the content for a text element, add the <TACT_f> marker. |
<TAESH> | True or False | t | Allows Editing Shadow By default, the shadow can be changed for point text elements. To disable the shadow button in the editor toolbar for a point text element, add the <TAESH> marker. If the Design Editor Preset has the shadow button disabled, this marker has no effect. |
<TAEST> | True or False | t | Allows Editing Stroke By default, the stroke can be changed for a point text element. To disable the stroke button in the editor toolbar for a point text element, add the <TAEST_f> marker. If the Design Editor Preset has the stroke button disabled, this marker has no effect. |
<TCC> | Value | 1 | Column Count Applies ONLY to PSD templates By default, a rich formatted text element has only one column. While Photoshop does not support multiple columns, the Online Designer does. To define more than one column for a rich text element, add the <TCC_x> marker, with x representing the desired number of columns. Example: <TCC_2> defines the rich text field to have two columns in the editor. |
<TACCC> | True or False | t | Allows Change Column Count By default, you can change the column count that was originally set up using the <TCC> marker, when using a Photoshop based template. To disable the Columns button in the editor toolbar, add the <TACCC_f> marker. |
<TCL> | Value | Character Limit By default, no character limit is defined for a rich text element. To define a character limit for a rich text element, add the <TCL_x> marker, with x representing the character limit. Example: <TCL_500> defines the character limit to be 500 characters. | |
<TMLC> | Value | Max Line Count By default, no line count limit is defined for a point or bounded text element. To define a line count limit for a point or bounded text element, add the <TMLC_x> marker, with x representing the line count limit. Example: <TMLC_3> defines the line count limit to be 3 lines. | |
<TMLL> | Value | Max Line Length By default, no characters per line limit is defined for a point or bounded text element. To define a characters per line limit for a point or bounded text element, add the <TMLL_x> marker, with x representing the characters per line limit. Example: <TMLL_50> defines the characters per line limit to be 50 characters. | |
<TOS> | Value | clip | Overflow Strategy Defines how to handle plain bounded or rich formatted text if it goes out of bounds.
By default, plain bounded or rich formatted text that goes out of bounds is clipped. To change how text is handled when it goes out of bounds, add the <TOS_x> marker, with x representing the overflow strategy. Example: <TOS_fitToWidth> defines the clipping behavior to shrink the text when the end of a line is reached. |
<TSM> | Value | size | Shrink Mode Defines how to handle plain bounded text if it goes out of bounds.
Example: <TSM_size> defines the shrink mode to change the font size. The scale mode is incompatible with the fitToBox overflow strategy. In this mode, the Online Designer automatically uses the fitToWidth strategy. |
<TPH> | True or False | t | Text Placeholder To enable a prompt in the editor canvas to fill out a bounded or point text element, add the <TPH> or <TPH_t> marker. If it's not filled out, the prompt is NOT shown on the proof or hi-res output. |
<TVA> | Value | top | Vertical Alignment Defines the vertical alignment for a text string in a text element.
By default, a text string is aligned to the top of a text element. To change the vertical alignment, add the <TVA_x> marker, with x representing the alignment value. Example: <TVA_bottom> defines the vertical alignment to be with the bottom of the text element. |
Shapes
Marker | Type | Default Value | Description |
---|---|---|---|
<SACBC> | True or False | t | Allows Change Border Color By default, the border color can be changed for a shape element and the bounding boxes of images and image placeholders. To disable the border color button in the editor toolbar for a shape element and the bounding boxes of images and image placeholders, add the <SACBC_f> marker. If the Design Editor Preset has the border color button disabled, this marker has no effect. |
<SACBW> | True or False | t | Allows Change Border Width By default, the border width can be changed for a shape element and the bounding boxes of images and image placeholders. To disable the border color button in the editor toolbar for a shape element and the bounding boxes of images and image placeholders, add the <SACBW_f> marker. |
<SACFC> | True or False | t | Allows Change Fill Color By default, the fill color can be changed for a shape element. To disable the fill color button in the editor toolbar for a shape element, add the <SACFC_f> marker. |
<SR> | True or False | t | Rasterize By default, shape elements are output as vector shapes in the Hi-Res Output. To force rasterization in the Hi-res Output based on the DPI specified in the Design Editor Preset, add the <SR> marker. |
Layers
Marker | Type | Default Value | Description |
---|---|---|---|
<LACO> | True or False | t | Allows Change Opacity of layers By default, the opacity can be changed for design elements. To disable the opacity slider in the editor toolbar for a design element, add the <LACO_f> marker. If the Design Editor Preset has the opacity slider disabled, this marker has no effect. |
<IASF_x> | Value | Not currently available. | |
<MVI> | Value | 1 | Not currently available. |
<MVIKT> | True or False | t | Not currently available. |
Images
Marker | Type | Default Value | Description |
---|---|---|---|
<AT> | Value | Not currently available. | |
<IACI> | True or False | t | Allows Change of Images and placeholder content By default, the editor allows users to replace the content of images and image placeholders. To disable the select image button in the editor toolbar for images and image placeholders, add the <IACI_f> marker. |
<IAEI> | True or False | t | Allows for Editing Images and placeholder content By default, the editor allows users to edit both images and content of image placeholders. To disable the edit image button in the editor toolbar for images and image placeholders, add the <IAEI_f> marker. |
<IAKOC> | True or False | t | Allows user to Keep Color Overlay By default, the editor resets the overlaying color when changing images and placeholders. To keep the overlaying color effect of images and placeholders being changed, add the <IAKOC_f> marker. |
<IE> | Value | none | Image Effect Defines the image effect applied to images and image placeholders.
By default, no effect is applied. To change the image effect, add the <IE_x> marker, with x representing the effect value. Example: <IE_blackAndWhite> defines the image effect to convert to black and white. <IE_colorize> defines the image effect to convert to grayscale. Should be paired with the <IFC> marker or images will be rendered white. |
<IFC> | Value | Image Fill Color This is used in conjunction with the <IE_colorize> marker to specify the CMYK or RGB color for the fill. Without this marker, the image will be rendered white. Example: <IE_colorize><IFC_100,0,0,0> defines the image to be converted to grayscale with a 100% cyan fill color. |
Image Placeholders
Marker | Type | Default Value | Description |
---|---|---|---|
<PACM> | True or False | t | Allows Cover Mode By default, the cover mode is disabled for placeholder images which may result in empty areas in the placeholder. To force an image inserted into a placeholder to cover the full area and prevent arbitrary resizing or rotating, add the <PACM_t> marker. |
<PAEC> | True or False | t | Allows Edit Content By default, image placeholder content can be edited. To prevent editing of placeholder content, add the <PAEC_f> marker. |
<PCHA> | Value | center | Aligns Placeholder Content Horizontally Defines the horizontal alignment of placeholder content in relation to the bounding box.
By default, the content is center horizontal aligned. To change the content horizontal alignment, add the <PCHA_x> marker, with x representing the alignment value. Example: <PCHA_right> defines the content horizontal alignment to be to the right of the bounding box. |
<PCVA> | Value | center | Aligns Placeholder Content Vertically Defines the vertical alignment of placeholder content in relation to the bounding box.
By default, the content is center vertical aligned. To change the content vertical alignment, add the <PCHA_x> marker, with x representing the alignment value. Example: <PCVA_bottom> defines the content vertical alignment to be to the bottom of the bounding box. |
<PH> | Value | normal | Placeholder type Defines the placeholder behavior.
By default, an image placeholder shows the image with placeholder behavior. To change the placeholder behavior, add the <PH_x> marker, with x representing the placeholder behavior. Example: <PH_stub> will show the image placeholder with a stub image that is not included in the hi-res output if the stub isn't replaced. |
<FSCS> | True or False | t | Fixes Stub Content Size By default, stub images are resized along with placeholders. To prevent the stub image from being resized with the placeholder, add the <FSCS_f> marker. |
<PHRM> | Value | fit | Placeholder Resize Mode Defines how an image inserted into the placeholder should be resized.
By default, the image is resized proportionally to fit the placeholder with the resulting image size equal to or smaller than the placeholder size. To change the resize behavior, add the <PHRM_x> marker, with x representing the placeholder resize behavior. Example: <PHRM_original> will place the image in the center of the placeholder at its original size. |
<PLID> | Value | Placeholder Identifier By default, placeholders are treated separately. Placeholders can be linked to share an image. When one of the linked placeholders has it's image replaced, all of the other linked placeholders will automatically be updated. To link placeholders, add the <PLID_x> marker, with x representing the name of the linked placeholders. Example: <PLID_headshot> marker is added to 3 out of 4 placeholders on a template. When the user updates the image on one of the placeholders with the <PLID_headshot> marker, the other two with the same marker will automatically be updated. | |
<PSSB> | True or False | t | Show Select Button By default, the select button is enabled on a placeholder to allow users to replace images. To disable this button on the placeholder image, add the <PSSB_f> marker. |
Barcode Placeholders
Marker | Type | Default Value | Description |
---|---|---|---|
<BACC> | True or False | t | Allows Change Content By default, users can edit barcodes. To remove the ability to edit a barcode, add the <BACC_f> marker. |
<BACT> | True or False | t | Allows Change Type By default, users can change the barcode type. To remove the ability to change the barcode type, add the <BACT_f> marker. |
<BPH> | Value | QR-CODE | Barcode Placeholders Defines a barcode stub in image layers.
By default, barcodes are imported as raster images. To change the import behavior to a stub, add the <BPH_x> marker, with x representing the barcode type. Example: <BPH_CODE-128> defines the barcode to be a stub and is encoded as a Code 128. |