Supported Markers

Markers are special symbols which you add to a layer name in PSD templates. Customer's Canvas uses the markers to manage permissions for each design element. Alternatively to markers in PSD templates, you can specify these permissions outside of PSD files in the JSON format. Also, Customer's Canvas supports shortcuts for both the markers and JSON definitions.

First, let us review the syntax of the markers. Each marker is enclosed in angle brackets (< ... >). Inside these brackets, there is a pair of a marker's name (usually, uppercase abbreviated) and a value, separated by an underscore (_). If there is no underscore (and, therefore, no value), for example <BG>, Customer's Canvas uses a default value for this marker.

Markers are case insensitive. Most of the markers are boolean values and may equal either t (true) or f (false). However, for certain markers, other value types may be applicable.

The markers can be divided into the following groups:

The table below contains all the markers supported by Customer's Canvas and their equivalent JSON definition.

Marker Type Default value Description with a JSON example
Manipulation behavior (in the advanced edit mode)
<MAAR> Boolean T Allows Arbitrary Resizing. Without this marker, only rich text and image placeholders can be arbitrary resized, whereas all the rest elements require <MAAR> for arbitrary resizing. This marker does not affect point text. This marker remains for backward compatibility; use <MRC> or <MRE> instead.
"manipulationPermissions": {
    "allowArbitraryResize": true
}
<MAD> Boolean T Allows Deleting. By default, your users can delete any element on the canvas in the advanced edit mode. <MAD_f> removes the Delete command from the editor's menus.
"manipulationPermissions": {
    "allowDelete": false
}
<MAMH> Boolean T Allows Move Horizontal. Without this marker, your users can move design elements on the canvas.
"manipulationPermissions": {
    "allowMoveHorizontal": false
}
<MAMV> Boolean T Allows Move Vertical. Without this marker, your users can move design elements on the canvas.
"manipulationPermissions": {
    "allowMoveVertical": false
}
<MAR> Boolean T Allows Rotation. By default, your users can rotate elements. A round grip appears above bounding rectangles indicating that the rotation is allowed.
"manipulationPermissions": {
    "allowRotate": false
}
<MAPR> Boolean T Allows Proportional Resizing. You can resize all design elements proportionally. Corner grips appear on bounding rectangles indicating that you can resize elements proportionally. This marker remains for backward compatibility; use <MRC> instead.
"manipulationPermissions": {
    "allowProportionalResize": false
}
<MRC> Enum of a | p | f p Defines how corner grips resize design elements:
  • a - enables corner grips and the arbitrary resize mode.
  • p - enables corner grips and the proportional resize mode.
  • f - disables corner grips.
By default, all design elements have corner grips on bounding rectangles allowing you to resize elements proportionally. Using permissions, you can define the corner array of two items: the first one is for normal dragging the corner grips, and the second one is for dragging the corner grips while holding down the Shift key. They can be either "Proportional" or "Arbitrary".
"manipulationPermissions": {
    "resizeGrips": {
        "corner": ["Proportional", "Arbitrary"]
    }
}
This permission is equal to the <MRC_pa> marker.
<MRE> Boolean T Enables edge grips on bounding rectangles allowing you to resize elements arbitrarily. By default, only rich text element can be arbitrary resized.
"manipulationPermissions": {
    "resizeGrips": {
        "edge": true
    }
}
Visualization behavior
<VNP> Boolean T No Print. By default, Customer's Canvas shows all design elements on the canvas, proof images, and high-resolution images. If you add <VNP> or <VNP_t> to a layer name, then the corresponding element appears only on the canvas. <VNP_f> results in the default behavior.
"visualizationPermissions": {
    "noPrint": true
}
<VNS> Boolean T No Show. By default, Customer's Canvas shows all design elements on the canvas, proof images, and high-resolution images. If you add <VNS> or <VNS_t> to a layer name, then the corresponding element does not appear on the canvas but it is rendered on the print-ready file and proof images.
"visualizationPermissions": {
    "noShow": true
}
Text behavior
<AST> Boolean T 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.
"autoScaledText": true
<FRT> Boolean T Forces Rich Text. This marker forces Customer's Canvas to load a paragraph layer as rich text regardless of text formatting. It is useful when a text layer in a PSD template is formatted in a single style but you want users to format it in multiple styles.
"forceRichText": true
<TACA> Boolean T Allows Change Alignment of point text. <TACA_f> disables the horizontal alignment buttons in the Top Toolbar for the marked point text element. These buttons are enabled by default. If the textAlignmentButtonsEnabled property is false, then <TACA_t> has no effect.
"textPermissions": {
    "allowChangeTextAlignment": false
}
<TACBIU> Boolean T Allows Change Bold Italic Underline styles of point text. <TACBIU_f> disables the Faux bold, Faux italic, and Underlined buttons in the Top Toolbar for the marked point text element. These buttons are enabled by default. If the textEmphasisButtonsEnabled property is false, then <TACBIU_t> has no effect.
"textPermissions": {
    "allowChangeTextBIU": false
}
<TACCC> Boolean T Allows Change Column Count for rich text. Without this marker, you can change a column count that you initially set up using the <TCC> marker. <TACCC_f> disables the Columns box in the Top Toolbar.
"pathBoundedTextPermissions": {
    "allowChangeColumnCount": false
}
<TACF> Boolean T Allows Change Font of point text. <TACF_f> disables the Font name and Font style lists in the Top Toolbar for the marked point text element. These buttons are enabled by default. If the textFontFamilyButtonEnabled and textFontStyleButtonEnabled properties are false, then <TACF_t> has no effect.
"textPermissions": {
    "allowChangeFont": false
}
<TACFC> Boolean T Allows Change Font Color of point text. <TACFC_f> disables the Color picker in the Top Toolbar for the marked point text element. By default, the Color picker is enabled. If the textFontColorButtonEnabled property is false, then <TACFC_t> has no effect.
"textPermissions": {
    "allowChangeFontColor": false
}
<TACFS> Boolean T Allows Change Font Size of point text. <TACFS_f> disables the Font size box in the Top Toolbar for the marked point text element. By default, this box is enabled. If the textFontSizeButtonEnabled property is false, then <TACFS_t> has no effect.
"textPermissions": {
    "allowChangeFont": false
}
<TACT> Boolean T Allows Change Text. <TACT_f> disallows for changing the content of both rich text and point text.
"textPermissions": {
    "allowChangeText": false
}
<TAESH> Boolean T Allows Editing Shadow. <TAESH_f> disables the Shadow button in the Top Toolbar for the marked point text element. By default, this button is enabled. If the textShadowButtonEnabled property is false, then <TAESH_t> has no effect. For details, refer to the Stroke and Shadow Text Effects topic.
"textPermissions": {
    "allowChangeShadow": false
}
<TAEST> Boolean T Allows Editing Stroke. <TAEST_f> disables the Stroke button in the Top Toolbar for the marked point text element. By default, this button is enabled. If the textStrokeButtonEnabled property is false, then <TAEST_t> has no effect. For details, refer to the Stroke and Shadow Text Effects topic.
"textPermissions": {
    "allowChangeStroke": false
}
<TCC> Number 1 Column Count of rich text. For example, <TCC_2> defines two columns for the rich text element. For details, refer to the Multi-Column Text topic.
"textColumnCount": 2
<TCL> Number Text Character Limit sets the maximum length of a text string which the user is allowed to enter into a specific rich text element. By default, such a limit is not defined.
"richTextCharacterLimit": 200
<TMLC> Number Text Max Line Count sets the maximum number of lines which the user is allowed to enter into a specific point text element. By default, such a limit is not defined.
"plainTextMaxLineCount": 2
<TMLL> Number Text Max Line Length sets the maximum length of text lines which the user is allowed to enter into a specific point text element. By default, such a limit is not defined.
"plainTextMaxLineLength": 7
<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 rich text and point text.
"textPlaceholder": true
<TVA> Enum of top | center | bottom top Defines vertical alignment for a text string in a rich text element:
  • top - aligns a text string with the top bound of the rich text area.
  • center - aligns a text string with the center of the rich text area.
  • bottom - aligns a text string with the bottom bound of the rich text area.
"textVerticalAlignment": "Center"
Shape behavior
<SACBC> Boolean T Allows Change Border Color. <SACBC_f> disables the Border color button in the Top Toolbar. This button defines a color of shapes. The shapes are both the shape design elements and bounding frames of images and image placeholders. If the borderColorButtonEnabled property is false, then <SACBC_t> has no effect.
"shapePermissions": {
    "allowChangeBorderColor": false
}
<SACBW> Boolean T Allows Change Border Width. <SACBW_f> disables the Border width button in the Top Toolbar. This button defines a width of shapes. The shapes are both the shape design elements and bounding frames of images and image placeholders.
"shapePermissions": {
    "allowChangeBorderWidth": false
}
<SACFC> Boolean T Allows Change Fill Color. <SACFC_f> disables the Fill color button in the Top Toolbar. This button is available for shape layers only. Neither images nor image placeholders have a fill color.
"shapePermissions": {
    "allowChangeFillColor": false
}
Layer behavior
<LACO> Boolean T Allows Change Opacity of layers. <LACO_f> disables the Opacity slider in the Top Toolbar. By default, this slider is enabled for all design elements. If the opacitySliderEnabled property is false, then <LACO_t> has no effect.
"itemPermissions": {
    "allowOpacityChange": false
}
Setting up Predefined Values for Layers
<IAPSF_folder> Text Image from Allowed Public Subfolder. You can specify a folder, which restricts an image selection. For example, <IAPSF_/europe_photos/> makes your users select an image from the europe_photos folder. This marker applies to both images and image placeholders. For details, see the Setting up Fields with Predefined Values topic.
"imageAllowedPublicGallerySubfolder": "europe_photos"
<MVI> Number 1 Multi Value Instance. For example, the <MVI_2> marker applies to a layer group that includes either image layers or text layers and displays the second element when the template opens. In Customer's Canvas, such a group represents a drop-down list so that your users can select its elements as the content for text fields or images. For details, see the Setting up Fields with Predefined Values topic.
"multiValueItem": true,
"mviFirstItemIndex": 2
<MVIKT> Boolean T Multi Value Instance Keeps Transforms. By default, the <MVI> group takes the size and position of the first element. The <MVIKT> marker allows you to keep transforms applied in PSD templates for a single group element.
"multiValueItem": true,
"multiValueItemKeepTransformation": true
Image behavior
<AT> Text Allowed Tabs defines from which gallery tabs images and placeholders can take their content. The value of this marker is a comma-separated list of tab names. For the details on how to configure gallery tabs, refer to the Using the Image Gallery topic. For example, <AT_My Files,Facebook> allows the selection only from the My Files and Facebook gallery tabs. By default, users can select images from any gallery tab.
"allowedTabs": ["My Files"]
<IACI> Boolean T Allows Change of Images and the placeholder's content. <IACI_f> removes the Select image command from the menus and disallows the double-clicking to replace images. By default, users can replace both images and the content of image placeholders.
"imagePermissions": {
    "allowChangeImage": false
}
<IAEI> Boolean T Allows for Editing Images and the placeholder's content. <IAEI_f> removes the Edit image command, which opens the Image Editor, from the menus. By default, users can edit both images and the content of image placeholders in the Image Editor.
"imagePermissions": {
    "allowEditImage": false
}
<IE> Enum of none | blackAndWhite | flipVertical | flipHorizontal none Image Effect allows the application of the black-and-white and flip effects to images, including image placeholders. When <IE_blackAndWhite> set up, the editor automatically converts a picture picked for an image layer to black and white.
  • none - no effects apply.
  • blackAndWhite - converts images to monochrome ones.
  • flipVertical - flips images around the vertical axis.
  • flipHorizontal - flips images around the horizontal axis.
"imageEffect": "FlipVertical"
Placeholder behavior (see the Image Placeholders topic)
<PACM> Boolean T Allows Cover Mode when no user manipulations with images result in empty areas in the placeholder. In this mode, you cannot arbitrary resize or rotate images in the placeholder. By default, the cover mode is disabled for image placeholders. <PACM_t> enables this mode. You can change the default behavior using the DefaultPlaceholderCoverModeEnabled key in web.config.
"isCoverMode": true
<PAEC> Boolean T Allows Edit Content. <PAEC_f> disallows for manipulating the image placeholder's content. By default, the corresponding handle appears and indicates that users can manipulate the content.
"placeholderPermissions": {
    "allowEditContent": false
}
<PCHA> Enum of center | left | right center Aligns the Placeholder's Content Horizontally. By default, the editor centers the content when users select images.
  • center - the center horizontal alignment.
  • left - the left horizontal alignment.
  • right - the right horizontal alignment.
"placeholderContentHorizontalAlign": "Left"
<PCVA> Enum of center | top | bottom center Aligns the Placeholder's Content Vertically. By default, the editor centers the content when users select images.
  • center - the center vertical alignment.
  • top - the top vertical alignment.
  • bottom - the bottom vertical alignment.
"placeholderContentVerticalAlign": "Bottom"
<PH> Enum of normal | empty | stub normal Enables placeholders based on image layers.
  • normal - the image with placeholder behavior.
  • empty - an empty placeholder (without an image).
  • stub - an image placeholder with a stub image; the stub image is not included in the high-resolution output.
"placeholder": true,
"placeholderType": "Empty"
<PHRM> Enum of fit | fill fit Defines how an image inserted into the placeholder should be resized (Placeholder Resize Mode). Without this marker, the fit option is applied. For details, see the Image Placeholders topic.
  • fit - the image is resized proportionally to fit the placeholder; resulting image size is equal to or smaller than the placeholder size.
  • fill - the image is resized proportionally to fill the placeholder; resulting image size is equal to or larger than the placeholder size.
"placeholderResizeMode": "Fill"
<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.
"placeholderLinkId": "photo"
<PSED> Boolean T Shows the Edit Button, which allows for manipulating images and content of image placeholders. This marker remains for backward compatibility; use <PAEC> instead.
"placeholderPermissions": {
    "allowEditContent": false
}
<PSSB> Boolean T Shows the Select Button on a placeholder. By default, this button is enabled and allows users to replace images.
"placeholderPermissions": {
    "showSelectButton": false
}
Behavior in an Object Inspector
<OIAZC> Boolean T Allows Z-order Change in the Object Inspector. By default, the Z-order commands are enabled for all design elements.
"itemPermissions": {
    "allowZOrderChange": false
}
<OID> Boolean T Defines whether to Display an element in the Object Inspector. <OID_f> hides a marked element in the Object Inspector, whereas they are displayed by default.
"frontendPermissions": {
    "displayInObjectInspector": false
}
<ORWS> Boolean T Out of Region Warning Show allows you to disable the corresponding warning. By default, the Object Inspector shows this warning when design elements go out of a region.
"frontendPermissions": {
    "showOutOfRegionWarning": false
}
Product Themes
<THMB> Enum of img | border | fill | text | stroke | shadow | line | alternateLine | horizontal | vertical Theme binding allows for recoloring the design elements in PSD templates. For example, <THMB_img:images> binds the img property to the images theme color.
"themeBinding": {
    "img": "images",
    "border": "borders",
    "text": "main"
}
Miscellaneous
<BG> Boolean T Background adds an object to a background layer. 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 layer.
"background": true
<BGIMG_file> Text 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_backgrounds/rose.jpg> marker sets the rose.jpg file as the design background. The file path is relative to the ~\ProductTemplates\designImages\ folder.
"background": true,
"backgroundImage": "backgrounds/rose.jpg"
<DPH> Boolean T Design Placeholder marks the layer where a design should be placed in a 3D preview mockup. For a 3D preview example, refer to the 3D Preview Mockups topic.
<FG> Boolean T Foreground adds an object to a foreground layer. Such an object cannot be edited by a user and is always located above any regular editable objects (i.e. has a greater z-order). By default, objects do not belong to the foreground layer.
"foreground": true
<FR> Boolean T Frame decorates a placeholder. <FR> or <FR_t> can be added to a raster layer. For details, see the Placeholders with Frames topic.
"frame": true
<LC> Boolean T Locked. <LC> and <LC_t> disallow for editing the marked layers. Such layers are not displayed in the Object Inspector.
"locked": true
<PBT> Boolean T Path Bounded Text sets up a shaped text. This marker can be applied to a layer group only. For details, see the Text Wrapping topic.
"pathBoundedText": true
<R> Boolean T Region limits an editable area to a bounding box of a layer, either a raster or shape one. 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": true
<ROLC> Boolean Remove On Layout Change allows you to keep the position and content of design elements using <ROLC_f> and remove them using <ROLC_t> when changing layouts. By default, Customer's Canvas replaces only text and image placeholders between layouts, if there are available placeholders, and removes other design elements.
"itemPermissions": {
    "allowRemoveOnLayoutChange": false
}
<TWM> Enum of tight | square | none none Text Wrapping Marker defines how the underlying text elements should wrap this element.
  • none - no wrapping.
  • square - wrap around the bounding rectangle.
  • tight - wrap around the element boundaries.
By default, text does not wrap elements. Only when you add barcodes to the canvas, they behave as if <TWM_square> is applied.
"textWrappingMode": "Tight"

See Also

Manual