Custom Gateway - Customer Support

Welcome to the Custom Gateway Support Portal

Here you can raise support tickets and read articles on common queries using the topic sections and search below

2d Product Creation | User Guide - Section 07: Text Areas


Section 07: Text Areas

7.1 Overview

A Text Area enables text personalisation functionality. Like Image Areas, a Text Area must be positioned WITHIN a specified Print Area. Each Print Area can have multiple Text Areas assigned to them, with either identical and/or different position and configuration settings.

The text size is represented in CSS Pixels. More information on CSS Pixels can be found here:

The origin point of the text area differs slightly to that of Print / Image Areas. The 'x' position determines the start point of the text input (based on the Horizontal Alignment option set). The 'y' position is representative of the centre point of the font boundary (based on the Vertical Alignment option set).

Important Note: Alignment options are set to Centre and Middle by default.

The result from the horizontal alignment options can be seen below can be seen below - these all share the same 'x' position:

The result from the vertical alignment options can be seen below can be seen below - these all share the same 'y' position:

7.2 General settings

Within the Text Area settings, there are multiple configurable options:


Name of the Text Area

X Pos (px)

Horizontal coordinate value in pixels

Y Pos (px)

Vertical coordinate value in pixels


Default font size value (value represents CSS Pixels).

UI Display Order

Can be used to set the order that the text area appears in the list of available text areas (when more than one text area exists on product).  1 = First, 2 = Second etc.

Char Limit

Value used to enforce a character limit

Maximum Lines

Sets a limit to the number of lines available (when Multi-line text is enabled)


Value used to rotate the text around its own axis

Placeholder Text

Display text on the 2D Product by default. End user input will replace the Placeholder Text.


Set specific preset text options available to the user (line return after each)

Arc (º)

Controls the angle of the text arc. Arc Enabled checkbox MUST be ticked. (2D ONLY)

Colour Area

Assign the Text Area to a specific Colour Area


Assign the Text Area to a specific Print Area


Basic Left, Centre or Right text alignment options.

CPP also offers 'Justification' options that forces text to fill a specified width via dynamic spacing (advanced).

Force Casing

Forces text to conform to a fixed casing (if supported by font).  Options are: UPPER, LOWER, TITLE (Captialises the first letter of each word).

Sync From

Syncs the Text Area to the specified Text Area from the list.  Can be used to populate multiple Text Areas using a single Text Area as input.

Render Mode

Select outline and fill options for the text.  Options are: fill / stroke / both.

Default Effect

The default effect applied to the image area.  See Section 11: Effects for more information on Effects.

Arc Direction Set to Up or Down to control the direction of both Arc and Auto-Arc (circular) text

Move Enabled

Checkbox to enable/disable interactive positioning controls

Rotate Enabled

Checkbox to enable/disable interactive rotation controls

Arc Enabled

Enables arc and auto-arc (circular) text


Enables the end user to add multiple lines of text

User Input Enabled

Checkbox to enable/disable user input eg used to preserve Placeholder Text

Use Placeholder in Artwork

Checkbox to determine whether placeholder text is added to Artwork if not overwritten

Use Default Rotation in Artwork

Preserves the default text orientation, allowing you to set angled text in the on-screen preview but generate straight text in the output file.

Is Required

Product will not be added to cart unless this field is completed

7.3 Text boundary

By default, text can appear anywhere within the specified Print Area using the drag and drop tools. Once enabled, the Text Boundary defines an area WITHIN the Print Area that the text can appear. It is defined using the X and Y coordinates system in the same way that an Image Area is defined.

Important Note: The X Pos and Y Pos values for the text area still control the position of the text and should be set within the confines of the text boundary.  If not, the text will be invisible as the text boundary crops anything outside of its border on-screen.

There are additional options available within the Text Boundary menu; Auto Fit (single line only), Auto Newline (multi line only), Auto Arc (single line only), Clip in Artwork and Mask (see Figure 2).

Figure 2.

7.3.1 Auto-fit

Auto Fit (single line only) automatically rescales the font size when the input text reaches the specified Text Boundary. It is context sensitive - it will only function if the Multiline facility is DISABLED.

7.3.2 Auto-newline

Auto Newline (multi line only) automatically adds a new line when the input text reaches the specified Text Boundary.  This feature is based on the entered word spacing and is context sensitive - it will only function if the Multiline facility is ENABLED.

7.3.3 Auto-arc

Auto arc can used to automatically bend text around the circumference of a circle based on the dimensions of the text boundary. Note that the width and height of the boundary should be identical to create a square for this feature to work correctly.  The direction of the text can be controlled with the arc direction drop-down in the main text area settings.  Note that the auto-arc feature does not work with multi-line text.

Additional information on this feature can be found here:

7.3.4 Clip in Artwork

When enabled this option will also clip text in the print output at the border of the text boundary.

This option is supported with Raster and Vector PDF output types only.

7.3.5 Mask

The Text Boundary Mask allows the user to create a custom Text Boundary shape, rather than using the default square/rectangle. The uploaded mask will be scaled 'relatively' to the specified Text Boundary size, regardless of the size that the mask is created. Therefore, it is recommended that the mask is created using the Text Boundary width and height pixel values.

Important Note: If you are experiencing clipping of the font at the text boundary, simply turn off 'Enabled', autofit, newline and arc only require the co-ordinates and size of the text boundary need to be specified.

7.4 Default colour

The Default Colour menu allows the user to specify the default text colour. This can be defined as a custom hexadecimal value preceded by 0x (for further information on hex codes see 10. Colour Areas). Alternatively, a colour can be selected from a preset list from the Colour (Predefined) drop down menu.

Important Note: The Default Colour options do not show an example of the input hex value or the selected preset colour. It is advised that the user should run a Print Test (see 12. Print Test) to assess whether the font colour is as desired.


7.5 Available Colours

Available Colours allows the selection of specific colours on a per Text Area basis. All colours set in the Font Sizes & Colours menu will be displayed here for selection for every specified Text Area.

For more information, see this dedicated article: Text Areas | Available Colours

7.6 Available fonts

The CPP currently features approximately 520+ fonts for use with 2D Products (Filter by HTML). Each newly created 2D Product will be attributed with a default set of approximately 40 font types, with around 500 then available for selection if required. These can be selected on a per Text Area basis for greater control over the possible personalisation.

Important Note: Users should be aware that there is currently no control to influence tracking, kerning and leading of any font type on the platform. The default metrics of the fonts are used by the browser. Some fonts may display differently in the App preview vs the print file. This is due to font metric not being optimised for online use within the font file itself - the most commonly affected are TTF and OTF fonts. For this reason, we advise that you regularly print test, and use Google fonts (specified in the 'Source' column.


More information on current Font Availability can be found in this dedicated article: What Fonts are Available in Personalise-iT

Users have the ability to create Custom Fonts which can be uploaded to the CPP. Details on Custom Fonts can be found in this article.

The Available Fonts menu displays a preview of each font, along with the name and compatibility (HTML and Flash). Only HTML enabled fonts will work with 2D Products - the font list can be refined to display these by using the HTML checkbox (see Figure 3). It is then possible to enable the desired fonts.

Figure 3.

By default, fonts display in the App in alphabetical order. It is possible to specify a default font on a per Text Area basis. This allows specified font types to load as an active selection when the App opens. This is controlled by a check box in the Available Fonts menu; 'Default'.

Important Note: This new feature is currently only supported in ACP2 / 3.

7.7 Texture Preview

The Texture Preview window shows the 2D Product and the associated Text Area. This can be clicked and dragged within the preview window to allow interactive positioning - although it is advised that the input fields will offer a more accurate solution when placing text. This is because the effect of the configurable options are not shown in the Texture Preview, therefore it only offers limited accuracy.

Important Note: To assess the Text configuration, run a Print Test.

7.8 VIDEO 06

Demonstration of Text Area Configuration


<< Back to contents >>

Was this article helpful?
2 out of 2 found this helpful