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 06: Image Areas


Section 06: Image Areas

6.1 Overview

An Image Area defines a fixed area for image personalisation WITHIN the specified Print Area coordinates. It is the Image Area that the end user will use to personalise the 2D Product with uploaded imagery.

Each Print Area on the product can have multiple Image Areas assigned to them - this offers multiple upload opportunities for the end user. The image areas can be identical, and thus overlap eachother and/or set in different positions and in various sizes, depending on what you want to offer.

Important Note: The origin of the Image Area is the top-left corner. Attempts to set an Image Area outside of the defined Print Area co-ordinates will result in an error.

Important Note: Ensure that the position and dimensions of your image area do not extend past the overall size of the 2d view as this is known to cause products to not work correctly in some browsers (most notably Safari and Firefox)

6.2 General Settings

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


Name of the Image Area

X Pos (px)

Horizontal coordinate value in pixels

Y Pos (px)

Vertical coordinate value in pixels

UI Display Order

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

Width (px)

Image Area width in pixels

Height (px)

Image Area height in pixels

Angle (degs)

Angle that uploaded images will be displayed at

Colour Area

Assign the Image Area to a specific Colour Area


Assign the Image Area to a specific Print Area Surface

Fit Mode

Select how uploaded images will be scaled to fit the Image Area (Largest Side or Smallest Side)


Preset list of mask shapes used to alter the shape of the Image Area

*Note: Masks will affect both the on screen preview and the output file generated by the system.

Sync From

Syncs the image area to the specified image area from the list.  Can be used to populate multiple image areas using a single image area.



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

Move Enabled

Checkbox to enable/disable interactive positioning controls

Rotate Enabled

Checkbox to enable/disable interactive rotation controls

Zoom Enabled

Checkbox to enable/disable interactive scaling controls

User Input Enabled

Checkbox to hide an image area from the end-user (useful if you don't want the end-user to be able to see sync'd image areas in the drop-down list for example).

Only Allow Gallery Images

Checkbox to restrict general image upload functionality so that only images from a gallery can be uploaded. See Section 13: Personalise-iT Image Galleries

Mask Menu Enabled

No longer a supported feature


6.3 Placeholder

A Placeholder image is a temporary image assigned to an image area. When the App loads, the Placeholder Image will appear by default. Once the end user uploads an image to the Image Area, it will replace the Placeholder image.

It is advised to always utilise some form of Placeholder image where applicable. This can not only make products look better visually, but also notify end users where the personalisation area is at a glance, and prompt them to add imagery / text. We offer a standard range of placeholder images that are available for use within the placeholder menu, or you can upload your own.

More information on using Placeholders can be found in this dedicated article: New Placeholder Image Gallery

Important Note: Placeholder images must be PNG format and as small as possible in terms of file size, as the image will be loaded directly in the App. We recommend under 1mb for best performance.

*For greater flexibility, it is possible to influence whether the Placeholder Image will be delivered in the output via the 'Use Placeholder In Artwork' option. The placeholder image should be 300dpi if being used for output purposes. Although, please consider that using large placeholder images (2mb and above) will lead to performance implications in the App - specifically when viewed on Mobile / Tablet devices. We highly advise using this approach if no other setup option is available, and only for smaller products where the size of the image files is less of a concern.


 6.4 Custom Masks

A Custom Mask allows you to control the shape of a user uploaded image, so that it only occupies a predetermined area on the product.

Custom Masks are required in PNG format and should be solid black (where you intend the image to show) on a transparent background, at 300dpi.

The uploaded Custom Mask will be scaled ‘relatively’ to the specified Image Area pixel width and height values so a matching Aspect Ratio is critical. For best quality output we recommend creating custom masks at print size / quality (300dpi).

Once uploaded, Custom Masks are added to the bottom of the list of pre-sets in the Mask drop down menu with a unique reference code (see Figure 1).  The custom mask then becomes available to all image areas of a product not only the area to which it was first uploaded.

Important Note: Any uploaded mask will affect the output generated by the CPP. If the mask is not producing clean lines on the output, ensure that it 300dpi, and try creating at a larger scale.

Figure 1.

6.5 Advanced / Minimum Image Resolution Recommendation

The Advanced option allows the user to input a recommended width and height (in pixels) for uploaded images. If the end user does not upload an image larger than these specified values, a Validation notification will be displayed (see Figure 2).  For more information please see this article.

Figure 2.

6.6 Texture Preview

The Texture Preview window shows the 2D Product and the associated Image Area. Currently, it does not show a live preview of the defined Print Area, so it is advised that Users keep note of the Print Area settings whilst configuring the Image Area.

The Image Area can be clicked and dragged within the preview window to allow interactive scaling and positioning.

6.7 VIDEO 05

Demonstration of Image Area Configuration


<< Back to Contents >>

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