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

PSD Import to Create Customisable 2d Products



The PSD Import routine is a game-changer. It allows you to set up your Customisable Products inside Photoshop, and then upload the PSD's directly to the CPP.

As far as the system is concerned, any products created in this way are standard, meaning that all functionality can be accessed and changed on the CPP as normal.


What are the benefits of using it?

Photoshop is considered one of the leading packages in photo editing, image creation and graphic design software, and thus is widely used amongst industry professionals. The PSD Import routine gives those users the option of being able to 'create' Customisable Products in an environment that they are familiar with, quickly and efficiently, without having to set up manually on CPP. It has the potential to speed up the creation process for many users.


How does it work?

Based on the structure and naming conventions specified in the PSD, we are able to break down and extract information from each layer of the file, and then piece them back together and put them in the correct place on CPP to create Customisable Products. In short, it's magic...


Gimme that spec!

The specification requirements are critical and have to be exact. The grouping, layering, and naming conventions must be followed exactly to minimise the likelihood of any errors or problems occurring upon upload. Please be aware of stray characters and spaces and the layer structure.



PSD filenames should be saved in the following format WITH hyphens:


Product Name can use underscores for spaces, they will be replaced when the file is imported. The Product Name refers to what the product will be called on CPP. This can be changed once imported.

The SKU is the unique identifier for the product and can contain numbers, letters, and underscores - they won't be replaced. This can be replaced once imported.




The PSD document must be square and should be generally be scaled at 800x800 pixels. In some instances it may be necessary to use larger sizes eg 1200x1200, although we would generally advise not to go any larger than that for performance reasons and implications on import performance due to larger file sizes.

The import routine has a combined file size limit of 50mb. Individual files should be smaller than this (around 10mb) to avoid timing out during the import process. 

The View Layer contains the product image. This is the image that will be presented to the end user, so make it look nice! If you intend to make the product work with the colour change facility on the CPP, please ensure that the image used is White / lightly coloured. This is because colours get applied as an overlay in CPP.

The Mask Layer is a solid black object on a transparent background which defines where personalisation/colour change can appear.

Print Areas (Size layer) / Image Areas / Text Areas should be defined using the rectangle shapes tool - this is important because the shapes determine the position and size of the areas on CPP. The default text position will always be central to the shape specified.

The PSD should be RGB Colour Mode. If set to CMYK, it can cause issues with the product preview images.



The PSD tree structure should be as follows:

# View_01_{Name}
  - View_01
  - Mask_01
  # Print_Area_01_{Name}
    - Text_Area_01_{Name}
    - Image_Area_01_{Name}
    - Size_{100x100}

If you require multiple print areas, add a Print Area Group. For additional image areas or text areas, add them as layers and number accordingly:

# View_01_{Name}
  - View_01
  - Mask_01
  # Print_Area_01_{Name}
    - Text_Area_01_{Name}
    - Text_Area_02_{Name}
    - Image_Area_01_{Name}
    - Image_Area_02_{Name}
    - Size_{100x100}
  # Print_Area_02_{Name}
    - Text_Area_01_{Name}
    - Image_Area_01_{Name}
    - Size_{100x100}

If using multiple views, add another View group and number it accordingly:

# View_02_{Name}
  - View_02
  - Mask_02
  # Print_Area_03_{Name}
    - Text_Area_01_{Name}
    - Image_Area_01_{Name}
    - Size_{100x100}



The layers with a # at the start are the Layer Groups. This requires a Group folder to be created. 

Indentation indicates the items are part of that group. 

The {} brackets are important to ensure that we can easily grab the parts of the layer name, which you can call what you wish within 18 characters. Ultimately, these names will be added to the relevant field on CPP.

The Size layer name determines what size artwork the system will generate for that Print Area in mm at 300dpi. These are based on width x height values and can be set to 2 decimal places. The shape used within this layer should be used to define the Personalisation Area on the product preview and should have a matching AR to the values set within the Layer name. 

All Groups and Layers must be named with only letters, numbers, underscores and the swirly brackets (braces) - this is because spaces and other brackets could cause issues when trying to import. All can be renamed on CPP after import.

When saving the PSD, please ensure that compatibility is maximised. This is generally the default setting - but Photoshop may ask you upon saving the PSD via a dialog box. You can specify this in the preferences menu. We need this to be enabled for the saved file as without it there will be compatibility issues when we attempt to extract the data.

Please avoid using any Photoshop layer effects or blend options - unless they are flattened / rasterised as part of the layer. 


How to Import to CPP

  1. Once you have your PSD files set up, log in to CPP as normal. With the product manager open, use the search category facility to select the category folder that you want to add products to.
  2. With the folder selected, click the 'With "Selected" dropdown menu, then select Import From PSD.
  3. Import your PSD files. The system will notify you if the upload to the server was successful.

You may have to wait a few moments whilst we process the information and create the products on the platform. Sit back and relax whilst we do the hard work!

Refresh your browser to see the new products being imported to the folder. These will be queued but will continue to be processed until all have been added to the specified folder.

Please note that it may take several minutes for your new products to be visible.

If the product does not appear, it is likely that the formatting or structure is not accurate to the required specification. Please review the PSD to troubleshoot any issues.

If you experience difficulties in successfully importing your PSD, please contact, quoting the filename of your PSD(s) and attach the file.


Example PSD File

Here is an example PSD of a product which features a single view, with 2 print areas, Image Areas, and Text Areas.


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