Markers in JSON format
The Design Editor uses so-called markers to manage permissions for each design element. Alternatively to the markers in Photoshop and InDesign files, you can specify these permissions outside of templates in the JSON format. In this topic, you can find a table of all the markers supported by the Design Editor and their equivalent JSON definition.
Now, let's look at the markers supported in Design Editor.
Manipulations
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<MAD> | boolean | t | Allows Deleting. By default, your users can delete any element on the canvas in the advanced edit mode. MAD marker |
<MADND> | boolean | t | Allows Drag-N-Drop. By default, the editor enables the drag-and-drop mode for image placeholders when you specify the MADND marker |
<MAMH> | boolean | t | Allows Move Horizontal. Without this marker, your users can move design elements on the canvas. MAMH marker |
<MAMV> | boolean | t | Allows Move Vertical. Without this marker, your users can move design elements on the canvas. MAMV marker |
<MAR> | boolean | t | Allows Rotation. By default, your users can rotate elements. A round grip appears below bounding rectangles indicating that the rotation is allowed. MAR marker |
<MRC> | enum of a | p | Defines how corner grips resize single design elements. Using permissions, you can define the MRC marker This permission is equal to the Disable corner grips | |
<MRE> | boolean | t | Enables edge grips on bounding rectangles allowing you to resize elements arbitrarily. By default, only rich formatted text and image placeholders can be arbitrarily resized. MRE marker |
Visualization
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<VNP> | boolean | t | No Print. By default, the Design Editor shows all design elements on the canvas, proof images, and high-resolution images. If you add VNP marker |
<VNS> | boolean | t | No Show. By default, the Design Editor shows all design elements on the canvas, proof images, and high-resolution images. If you add VNS marker |
Text
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<ART> | boolean | t | Enables ARched Text based on the text on a path. Note that the path drawn in the template will be replaced with a circle or a line (when the bend is undefined). By default, text on a path appears as curved text. ART marker |
<ARTB> | float | 0 | ARched Text Bending defines the sector of the circle that is used to draw the text, in the range [ ARTB marker |
<AST> | boolean | t | Applies only to PSD templates. Automatically Scales Text to fit the bounding rectangle. This marker is only applied to point text and allows for arbitrary resizing such text. When you change the content of point text, the original text bounds remain unchanged and the text is scaled disproportionately to fit these bounds. By default, you can resize point text only proportionally. AST marker |
<TACA> | boolean | t | Allows Changing Alignment of point text. TACA marker |
<TACBIU> | boolean | t | Allows Changing Bold Italic Underline styles of point text. TACBIU marker |
<TACCC> | boolean | t | Allows Changing Column Count for rich formatted text. Without this marker, you can change a column count that you initially set up using the TACCC marker |
<TACF> | boolean | t | Allows Changing Font of point text. TACF marker |
<TACFC> | boolean | t | Allows Changing Font Color of point text. TACFC marker |
<TACFS> | boolean | t | Allows Changing Font Size of point text. TACFS marker |
<TACSTC> | boolean | t | Allows Change Stroke Color. <TACSTC_f> disallows for changing the color of text stroke. In this case, the stroke color will be the same as the text color. TACSTC marker |
<TACT> | boolean | t | Allows Changing Text. TACT marker |
<TAESH> | boolean | t | Allows Editing Shadow. TAESH marker |
<TAEST> | boolean | t | Allows Editing Stroke. TAEST marker |
<TATF> | enum of true | false | null | true | Allows Text Formatting defines how to edit text elements: change only the content in a pop-up box or change both content and format in the Rich text editor. Without this marker, text will be edited depending on
TATF marker |
<TCC> | number | 1 | Applies only to PSD templates. Column Count of formatted text. For example, TCC marker |
<TCL> | number | Character Limit sets the maximum length of a text string which the user is allowed to enter into a rich formatted text element. By default, such a limit is not defined. TCL marker | |
<TMLC> | number | Max Line Count sets the maximum number of lines that the user is allowed to enter into a point text or plain bounded text. By default, such a limit is not defined. For details, refer to the character and line count topic. TMLC marker | |
<TMLL> | number | Max Line Length sets the maximum number of characters that the user is allowed to enter into a single line of point text or plain bounded text. By default, such a limit is not defined. For details, refer to the character and line count topic. TMLL marker | |
<TOS> | enum of clip | expandBox | fitToBox | fitToWidth | clip | Overflow Strategy defines how to change plain bounded or rich formatted text if it goes out of its bounds. By default, such a text is clipped.
TOS marker |
<TPH> | boolean | t | Text Placeholder motivates a user to fill out a text element. It shows a prompt on the canvas and if not filled out, it appears neither in the hi-res output nor on proof images. This marker is applicable for both bounded and point text. TPH marker |
<TSM> | size | size | Shrink Mode of plain bounded text that goes out of its bounds and should be fitted. This marker changes the font size. Without this marker, such a text is clipped by default. TSM marker |
<TVA> | enum of top | center | bottom | top | Defines Vertical Alignment for a text string in a text area:
TVA marker |
Shapes
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<SACBC> | boolean | t | Allows Changing Border Color. SACBC marker |
<SACBW> | boolean | t | Allows Changing Border Width. SACBW marker |
<SACFC> | boolean | t | Allows Changing Fill Color. SACFC marker |
<SR> | boolean | t | Rasterizes shape elements. SR marker |
Layers
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<LACO> | boolean | t | Allows Changing Opacity of layers. LACO marker |
| Setting up predefined values for layers | |||
<IASF_folder> | Text | Image from Allowed Subfolder. You can specify a subfolder in IASF marker | |
<MVI> | number | 1 | Applies only to PSD templates. Multi-Value Item. For example, the MVI marker |
<MVIKT> | boolean | t | Applies only to PSD templates. Multi-Value Item Keeps Transforms. By default, the MVIKT marker |
Images
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<AT> | Text | Allowed Tabs specifies tabs from which your users can select the content for images and placeholders. The value of this marker is a comma-separated list of tab names. For example, AT marker | |
<IACI> | boolean | t | Allows Changing the Images and the placeholder's content. IACI marker |
<IAKOC> | boolean | t | Allows you to Keep an Overlay Color for images and the placeholder's content. IAKOC marker |
<IAEI> | boolean | t | Allows for Editing Images and the placeholder's content. IAEI marker |
<IE> | enum of none | blackAndWhite | blackAndTransparent | grayscale | colorize | flipVertical | flipHorizontal | none | Image Effect allows the application of the black-and-white, grayscale, and flip effects to images, including image placeholders. When
IE marker |
<IFC> | string | Image Fill Color applies a CMYK or RGB color to grayscale images. Without this marker, the IFC marker | |
<RVC> | boolean | t | Deprecated, use RVC marker |
Image placeholders
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<PACM> | boolean | t | Allows Cover Mode when the user cannot pull the image out of the placeholder bounds or make it smaller than the placeholder itself. In this mode, you cannot arbitrarily resize or rotate images in the placeholder, however, you can rotate them 90 degrees using the Top Toolbar. By default, the cover mode is disabled for image placeholders. PACM marker |
<PAEC> | boolean | t | Allows Edit Content. PAEC marker |
<PCHA> | enum of center | left | right | center | Aligns the Placeholder's Content Horizontally. By default, the editor centers the content when users select images.
PCHA marker |
<PCVA> | enum of center | top | bottom | center | Aligns the Placeholder's Content Vertically. By default, the editor centers the content when users select images.
PCVA marker |
<PH> | enum of normal | empty | stub | normal | Enables placeholders based on image or shape layers.
PH marker |
<PHRM> | enum of fit | fill | original | fit | Defines how an image inserted into the placeholder should be resized (Placeholder Resize Mode). Without this marker, the
PHRM marker |
<PLID> | Text | Placeholder Identifier allows a user to define linked image placeholders to share an image. For more information, see the Linked Image Placeholders topic. PLID marker | |
<PSSB> | boolean | t | Shows the Select Button on a placeholder. By default, this button is enabled and allows users to replace images. PSSB marker |
Barcode placeholders
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<BACC> | boolean | t | Allows Changing Content. By default, your users can edit barcodes. BACC marker |
<BACCL> | boolean | t | Allows Changing Color. By default, your users can change both the color and fill color of barcodes. BACCL marker |
<BACT> | boolean | t | Allows Changing Type. Without this marker, your users cannot change the barcode type. BACT marker |
<BPH> | enum of EAN-8 | EAN-13 | UPC-A | UPC-E | IMB | QR-CODE | CODE-128 | DATA-MATRIX | QR-CODE | Enables stub Barcode Placeholders based on image layers. Without this marker, the Design Editor imports barcodes as raster images. Important! The barcode type separator in templates and JSON files is different. In templates, use a hyphen: BPH marker |
Object inspector
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<OIAZC> | boolean | t | Allows Z-order Change in the Object Inspector. By default, the Z-order commands are enabled for all design elements. Note, if a design element has the OIAZC marker |
<OID> | boolean | t | Defines whether to Display an element in the Object Inspector. OID marker |
Product themes
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<STYLE> | Text | Style allows you to change colors and text properties of design elements in product templates. The value of this marker is a design element category. For example, STYLE marker | |
<THMB> | enum of img | border | fill | text | stroke | shadow | line | barcode | Theme binding allows for recoloring the design elements in product templates. For example, THMB marker |
Spot containers
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<CN> | Text | Container Name creates a channel container and a channel tab in the Object Inspector. For example, CN marker | |
<COC> | Text | Container Output Color defines the color to be used for rendering texture and spot containers in PDF files. The value can be specifyed in RGB or CMYK color spaces. For example, COC marker | |
<PSC> | Text | Preview Spot Color specifies a preview color in the CNspot marker | |
<TFP> | Text | Texture File Path creates a texture container. This value does not have underscores and is relative to the CNtexture marker | |
<TK> | Text | Translation Key allows localization of channel tab names in the Object Inspector. For example, CNTK marker |
Groups
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<AGRA> | enum of left | top | right | bottom | center | none | none | Auto-layout Group Alignment aligns design elements in a group. By default, grouped elements are unaligned.
AGRA marker |
<AGRAP> | enum of start | center | end | start | Auto-layout Group Anchor Point allows you to define a point relative to which the layout will be rearranged when nested elements appear or hide in the group. You can anchor the layout to the
AGRAP marker |
<AGRM> | number | auto | Auto-layout Group Margin allows you to define spacing between elements in a group. By default, the elements will be placed at the same distance from each other. AGRM marker |
<AGRO> | enum of vertical | horizontal | auto | Auto-layout Group Orientation arranges design elements in a group vertically or horizontally. Without this marker, the elements are arranged depending on their position so that they fit the design. AGRO marker |
<GR> | enum of t | f | autolayout | t | Group defines how to import layer groups from product templates. Without this marker, layer groups are imported depending on the
GR marker |
<GARC> | boolean | t | Allows Replacing Content. Without this marker, your users can replace the contents of grouped design elements one by one. GARC marker |
Violation warnings
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<VSAR> | boolean | t | Allows Region Violation. ORWSVSAR marker |
<VSASL> | boolean | t | Allows Safety Line Violation. LVSASL marker |
<VSAIQ> | boolean | t | Allows Image Quality Violation. VSAIQ marker |
<VSAS> | boolean | t | Allows Shape Violation. VSAS marker |
<VSATC> | boolean | t | Allows Text Crop. VSATC marker |
<VSABA> | boolean | t (f) | Allows Bleed Area Violation. An element with VSABA marker |
<VSAIT> | boolean | t | Enables In-place Text editing warnings. VSAIT marker |
Miscellaneous
| Marker | Type | Default value | Description with a JSON example |
|---|---|---|---|
<BG> | boolean | t | Background adds a layer to the Background layer container. Such a layer always has a lower Z-order value than any layer edited by a user. It cannot be selected, edited, or deleted. By default, objects do not belong to the Background container. BG marker |
<BGIMG> | Text | Applies only to PSD templates. Background Image adds an image to the background layer. You can copy the image to your server and apply it to several PSD templates. For example, the BGIMG marker | |
<FG> | boolean | t | Foreground adds a layer to the Foreground layer container. Such a layer is always located above any regular layer (i.e. has a greater z-order). By default, objects do not belong to the Foreground container. FG marker |
<FR> | boolean | t | Applies only to PSD templates. Frame decorates a placeholder. FRmarker marker |
<LC> | boolean | t | Locked. LC marker |
<PBT> | boolean | t | Applies only to PSD templates. Path Bounded Text sets up a shaped text. This marker can be applied to a layer group only. For details, see the wrapping text inside a shape topic. PBT marker |
<R> | boolean | t | Region limits an editable area to a bounding box of a layer, either a raster or shape layer. Users will not be able to add any element outside of this region. A layer with this marker does not show in the Object Inspector. Region marker |
<ROLC> | boolean | Applies only to PSD templates. Remove On Layout Change allows you to keep the position and content of design elements using ROLC marker | |
<TWM> | enum of tight | square | none | none | Text Wrapping Marker defines how the underlying text elements should wrap this element.
By default, text does not wrap elements. When you add raster images to the canvas, they behave as if TWM marker |
<VAR> | boolean | t | Variable item. This marker sets the VAR marker |
Marker shortcuts
| Marker | Possible values | Description |
|---|---|---|
<LPH> | Enables stub Logo Placeholders in the LPH marker | |
<PPH> | Enables stub Photo Placeholders in the PPH marker | |
<PSLD> | Position Locked Deletable prevents users from moving, rotating, or resizing design elements. This shortcut is equal to the set of PSLD marker | |
<PSLUD> | Position Locked Undeletable prevents users from moving, rotating, resizing, or deleting design elements. This shortcut is equal to the set of PSLUD marker | |
<UML> | Up Mockup Layer enables an overlay mockup in the foreground container. This shortcut is equal to the set of UML marker |