Catalog Pictures

Each product in your catalog can have a picture. In your catalog spreadsheet, the image_uri column holds the filename of that picture (e.g. 12345.png). The filename must be an exact match — including the file extension — or the image will not appear in your planograms.

This page covers:

Uploading Pictures — how to add images to your site, including importing from hosted URLs
Picture Guidelines — resolution, cropping, and transparency
Image Processing Tools — automatic crop, background removal, and resize
Picture Orientations — front, side, and top views

Uploading Pictures

From the Admin → Catalogs page, select the Update via Files and Add Pictures tabs. Select one or more image files from your local computer, and click Upload Pictures to upload them to your site.

Options for uploading pictures to your site.

Pictures must be in .PNG, .JPG, or .WEBP format.

Importing from Hosted URLs

If your image_uri values are web URLs (e.g. https://example.com/images/12345.png), GoPlanogram will ask if you want to copy those images into your site when you upload your spreadsheet. This is an easy way to add pictures -- you do not need to upload any image files yourself.

Prompt to copy hosted images into GoPlanogram.

It's recommended to say yes to this prompt and copy the images to GoPlanogram. Images hosted on other websites can cause display problems in planograms due to cross-origin restrictions. Copying them into GoPlanogram avoids this issue entirely.

When the images are copied over, you can choose to process them with the same Crop and Remove Backgrounds options described in the Image Processing Tools section below.

Web URLs can also get into your catalog without that prompt: from the API, from editing an item in-app, or from choosing not to copy during an upload. To copy these later, open the View Content tab of the Admin → Catalogs page. If any items have pictures that are not yet copied, a Hosted Images button shows how many. Click it to list only those items, then use Copy All, or select some rows and use Copy Selected.

Copying does not change what you see. GoPlanogram keeps showing the original URL in the app and in catalog downloads, while the picture itself is served from your site.

Picture Guidelines

Resolution

Your picture (the front view) can be any resolution, but should be proportional to the Width / Height you give in your products spreadsheet.

So, a 5" wide x 20" tall product's picture should have approximately 4 times the pixels vertically as it does horizontally. GoPlanogram will scale the picture you give us into the dimensions in your spreadsheet.

As a general rule, a picture should have at least 10 pixels of size for each real-world inch. GoPlanogram allows for higher resolution images, but at sufficiently high resolution, large images can slow down planogram editing.

Cropping

Here is a sample picture. The blue line is the actual border for the picture.

The large white space around this product will show up in your planograms, which is usually not desired. When you tell GoPlanogram that this product is 5" x 20", it will look like this in the planogram:

For best results, crop any "dead space" around your product images. When cropped properly and scaled correctly, images will look much better in your planograms.

GoPlanogram can handle this cropping for you automatically — see Image Processing Tools below.

Background Transparency

Some packages are not complete rectangles. If you upload PNG pictures with transparent backgrounds, GoPlanogram will support this transparency. Note that JPG files do not support transparency.

When your products are displayed on a non-white background, transparency is more important in making a readable display, as the sample of a custom drink cooler shows.

The pictures with transparency on the bottom shelf have much cleaner edges, and will more accurately help your team design displays reflective of real-world conditions.

If your images don't already have transparent backgrounds, GoPlanogram can remove white and gray backgrounds for you — see Image Processing Tools below.

Image Processing Tools

GoPlanogram provides built-in tools to crop, remove backgrounds from, and resize your product images. All processing is done directly in your browser — no image data is sent to external services.

Processing During Upload

When uploading pictures on the Add Pictures tab, the following options are available to automatically process your images before they are uploaded:

Crop Images — Automatically crops white and gray borders around your product images, removing the "dead space" described above. This option is enabled by default.
Ignore small marks — Shown when Crop Images is ticked. Some pictures have tiny stray marks near the edge, such as specks from a scan. Cropping stops at those marks, so the picture keeps a wide blank border. Raising this lets cropping ignore small marks and trim in to the product itself. At 0% (the default) every mark is kept, which is the exact crop GoPlanogram has always performed. Setting it much above 5% can start trimming off small parts of the product.
Remove Backgrounds — Removes white and gray backgrounds from your images, giving them transparency. This option will convert your images to PNG format. If your catalog items reference a different file extension (e.g. .jpg), you may need to update the Image_URI values in your catalog spreadsheet to match the new .png filenames.

You can enable both options at once, but keep in mind that processing large batches of images (especially with both options enabled) may take several minutes.

Catalog Image Browser

To process images that have already been uploaded, use the Browse / Process Catalog Images button on the Add Pictures tab. This opens the Catalog Image Browser, which displays all uploaded images for a catalog in a searchable table.

From the Image Browser you can:

Browse and search all uploaded images for a catalog, and see which catalog items reference each image.
Process selected or all images with the same Crop and Remove Backgrounds options available during upload, plus an additional Resize option that scales images so the longest side does not exceed a specified maximum pixel dimension.
Download selected images as a ZIP file.

The Catalog Image Browser with processing options.

This is especially useful when you want to re-process images that were originally uploaded without cropping or background removal, or when you need to resize images in bulk to improve planogram loading performance.

Picture Orientations

By default, the image specified by Image_URI in your catalog spreadsheet refers to the Front image.

GoPlanogram also supports Side and Top images.

To utilize orientation images, in your products spreadsheet, provide an Image_URI with the .1 suffix, and ensure the picture you upload matches this filename exactly. Now GoPlanogram knows you plan to provide multiple orientation pictures for this product.

For Side and Top images, the suffix is .2 and .3, respectively.

For example, if the the Voodoo Ranger IPA product above originally had Image_URI 75452700066.png, change it in the spreadsheet to 75452700066.1.png to let GoPlanogram know you will be uploading side/top images. Ensure the image 75452700066.1.png is uploaded to your site.

Then, upload Side and/or Top images with name(s) 75452700066.2 and 75452700066.3, respectively.

If you don't have the Side or Top pictures, you will still be able to set the product orientation, but the Front image will get stretched to fit the Side or Top dimensions.