Meet us at SGIA Expo. Las Vegas, NV. Oct. 18—19.

Supported Markers

Markers are special symbols which you add to a layer name in PSD templates or to an element name in IDML templates. Customer's Canvas uses these markers to manage permissions for each design element. Alternatively to markers in Photoshop and InDesign files, you can specify these permissions outside of templates 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 Deprecated, use <MRC> or <MRE> instead. Allows Arbitrary Resizing. Without this marker, only rich formatted 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.
"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
}
<MADND> Boolean 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, <MADND_f> disables dragging the content of placeholders.
"manipulationPermissions": {
    "allowDragAndDrop": 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 Deprecated, use <MRC> instead. Allows Proportional Resizing. You can resize all design elements proportionally. Corner grips appear on bounding rectangles indicating that you can resize elements proportionally.
"manipulationPermissions": {
    "allowProportionalResize": false
}
<MRC> Enum of a | p 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.
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 formatted text and image placeholders can be arbitrarily 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 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.
"autoScaledText": true
<FRT> Boolean T Deprecated, use <RT> instead. Forces Rich Text. This marker forces Customer's Canvas to load a paragraph layer as rich formatted 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
<RT> Enum of true | false | auto true Rich Text defines how Customer's Canvas handles paragraph text layers and text frames. Without this marker, they appear as formatted text.
  • true - enables rich text formatting.
  • false - enables plain formatting.
  • auto - enables rich formatting only if it contains different styling.
"richTextMode": false
<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 formatted 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 bounded 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 Effects in Customer's Canvas 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 Effects in Customer's Canvas topic.
"textPermissions": {
    "allowChangeStroke": false
}
<TCC> Number 1 Applies only to PSD templates. Column Count of formatted text. For example, <TCC_2> defines two columns for the rich formatted 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 rich formatted 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 or plain bounded text element. By default, such a limit is not defined.
"textMaxLineCount": 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 or plain bounded text element. By default, such a limit is not defined.
"textMaxLineLength": 7
<TOS> Enum of clip | fitToBox | fitToWidth clip Text Overflow Strategy defines how to change plain bounded text if it goes out of its bounds. By default, such a text is clipped. For details, refer to the Copyfitting topic.
  • clip - while typing, crop the excessive text.
  • fitToBox - when the end of a line is reached, move to the next line first, and when the bottom of the bounding box is reached, then shrink the text.
  • fitToWidth - when the end of a line is reached, shrink the text.
"overflowStrategy": "FitToWidth"
<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.
"textPlaceholder": true
<TSM> Enum of scale | size size Text Shrink Mode of plain bounded text that goes out of its bounds and should be fitted. By default, such a text is clipped. For details, refer to the Copyfitting topic.
  • scale - shrinks the text in width or height.
  • size - changes the font size.
"textShrinkMode": "Scale"
<TVA> Enum of top | center | bottom top Defines vertical alignment for a text string in a text area:
  • top - aligns a text string with the top bound of the text area.
  • center - aligns a text string with the center of the text area.
  • bottom - aligns a text string with the bottom bound of the rich formatted 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 Deprecated, use <IASF> instead. 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.
"imageAllowedPublicGallerySubfolder": "europe_photos"
<IASF_folder> Text Image from Allowed Subfolder. You can specify a subfolder within PublicGalleryFolder, which restricts an image selection. For example, <IASF_/europe_photos/> makes your users select an image from the europe_photos subfolder. This marker applies to both images and image placeholders. For details, see the Specifying the Image Source Folder topic.
"imageAllowedGallerySubfolder": "europe_photos"
<MVI> Number 1 Applies only to PSD templates. Multi-Value Item. 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 Applies only to PSD templates. Multi-Value Item Keeps Transforms. By default, the <MVI> group takes the size and position of the first element. If you use <MVIKT> together with <MVI>, then every group element keeps transforms applied in PSD templates.
"multiValueItem": true,
"multiValueItemKeepTransformation": true
Image behavior
<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 the details on how to configure Gallery tabs, refer to the Using the Image Gallery topic. For the details on configure tabs of the Asset Manager, refer to The Asset Manager topic. For example, <AT_User,Facebook> allows the selection only from the My Files and Facebook gallery tabs. By default, users can select images from any tab.
"allowedTabs": ["User", "Facebook"]
<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
}
<IAKOC> Boolean T Allows you to Keep an Overlay Color for images and the placeholder's content. <IAKOC_t> keeps the color overlay effect of design elements being changed on the canvas, while <IAKOC_f> resets the color overlay specified in a template. By default, the editor resets an overlaying color when changing images.
"imagePermissions": {
    "keepOverlayColor": true
}
<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"
<RVC> Boolean T Applies only to PSD templates. Rasterizes Vector Content. <RVC_f> keeps the vector content of corresponding smart layers. Without this marker, Customer's Canvas imports vector graphics depending on the RasterizeVectorInSmartFrame parameter.
"rasterizeVectorContentInSmartFrame": true
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 arbitrarily 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 of Barcode placeholders
<BACT> Boolean F Allows Change Type. Without this marker, your users cannot change the barcode type.
"barcodePermissions": {
    "allowChangeBarcodeType": true
}
<BPH> Enum of EAN-8 | EAN-13 | QR-CODE none Enable stub Barcode Placeholders based on image layers. Without this marker, Customer's Canvas imports barcodes as raster images.
"placeholder": true,
"placeholderType": "Stub"
"barcodePlaceholderType": "EAN-8"
Behavior in the 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. Note, if a design element has the <OIAZC_f> marker, then other elements cannot be moved across this one.
"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. This marker does not affect background layers, and the bgItemEnabled configuration parameter defines their appearance.
"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
<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_FancyText> applies the FancyText style to the corresponding element. For more details, see the Product Themes topic.
"themeBinding": {
    "styles": ["FancyText"]
}
<THMB> Enum of img | border | fill | text | stroke | shadow | line Theme binding allows for recoloring the design elements in product templates. For example, <THMB_img:images> binds the img property to the images theme color. For more details, see the Product Themes topic.
"themeBinding": {
    "img": "images",
    "border": "borders",
    "text": "main"
}
Spot channels (see IFrame API)
<CN> Text Applies only to PSD templates. Container Name creates a channel container and a channel tab in the Object Inspector. For example, <CN_spotColor> creates a channel container with the spotColor name. This marker can be applied to a layer group only and expects either <PSC> or <TFP> for this group. By default, regular layers belong to the Main container.
"containerName": "spotColor",
"previewSpotColor": "rgb(0,255,0)"
<PSC> Text Applies only to PSD templates. Preview Spot Color specifies a preview color in the rgba(r,g,b,a) format for a channel container. For example, <CN_spot> <PSC_rgb(255,0,0,255)> markers specify red color for the spot container.
"containerName": "spotColor",
"previewSpotColor": "rgb(255,0,0,255)"
<TFP> Text Applies only to PSD templates. Texture File Path creates a texture container. This value does not have underscores and is relative to the ~/ProductTemplates/designImages/ folder.
"containerName": "texture",
"textureFilePath": "textures/sand.jpg"
<TK> Text Applies only to PSD templates. Translation Key allows localization of channel tab names in the Object Inspector. For example, <TK_ObjectInspector.SPOT_COLOR_CONTAINER> uses the SPOT_COLOR_CONTAINER key in ObjectInspector in your ~/Configuration/translations.json file.
"containerName": "spotColor",
"previewSpotColor": "rgb(0,255,0)"
"translationKey": "ObjectInspector.SPOT_COLOR_CONTAINER"
Miscellaneous
<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.
"background": true
<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_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 Applies only to PSD templates. 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 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.
"foreground": true
<FR> Boolean T Applies only to PSD templates. 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 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 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 Applies only to PSD templates. 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. When you add raster images to the canvas, they behave as if <TWM_square> is applied.
"textWrappingMode": "Tight"

See Also

Manual