Product images in templates

If you wish to display product images in your template, the best option is to host the images externally (for example, on a web store) and use a custom field to pull the images into your templates.

This guide will go through how to set up the custom field and configure your templates to use it.

Note: While Brightpearl allows you to upload product images directly against products, that functionality is only intended for use with Brightpearl POS and cannot be used to pull images into templates.

How to show a product image on a document

  1. Go to Settings > Custom fields > Products and create a new custom field of type "text area". Make a note of the custom field code - it will be needed later.


  2. The image URL needs to be added to the custom field. However, adding the URL on its own won't cause the image to display on documents - it needs to be entered with all the necessary HTML tags.
    The easiest way to do this, without needing to understand any HTML is to use the WYSIWYG editor, which is only available on "text area" custom fields. Click on the Image icon and paste the image URL into the pop up window.



    Click the HTML editor icon to view the full HTML recorded in the custom field:


    Alternatively, you can import the HTML code directly into the custom field.
  3. Finally, add the custom field as a column on the product table widget within the document template. Go to Settings > Templates > Document templates and click on your template.
    Scroll to the bottom of the screen and add the custom field as a column by entering the custom field code (prefixed with "PCF_"), followed by the column header as it should appear on the document:


  4. The next time the template is used and products with an image added in this way are on the record, the images will be displayed.


Using images for variants

The nature of variant products is that changes made on one product will be copied across all products in the group.

This means that simply adding an image to one of the products using the manual step above will add the same image to all the products in the group.

However, that's not to say that they can't each have a unique image.

To add an image to one variant only, follow the steps above, but, before saving, go to the product name and make an edit. For example, enter a space and then delete it. Doing so will display a checkbox just below the name, titled "Update item without updating the other sisters".

Check this box and save.

As long as the name is edited and then changed back, it will remain part of the variant group.


Alternatively, the full HTML can be added for each variant using a product import.

Have more questions? Submit a request