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 |
<RT> | enum of true | false | auto | true | Rich Text defines how the Design Editor handles paragraph text layers and text frames when
RT 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 | |
<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 | ||
<TMLL> | number | ||
<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. Whithout 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
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
Spot containers
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 | |
<LC> | boolean | t | Locked. LC marker |
<PBT> | boolean | t | |
<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 |