---
title: "Mockup-based product images | Customer's Canvas Hub"
canonical: "https://customerscanvas.com/docs/hub/dev-center/scenarios/product-images/"
---

# Mockup-based product images

> You can use Customer's Canvas to create product galleries. The API generates these images by using product mockups and personalized artworks.

One of the use cases where Customer's Canvas may be helpful is creating images based on mockups.

For example, you are building a print-on-demand (POD) system where you have a catalog of some products, let's say, different types of mugs. Your customers sell mugs with their artwork on their websites. You may want to simplify the process of publishing such products by automatically generating a product image, where the mug image stored in your catalog is combined with the artwork the customer uploads.

This article provides an overview of how this scenario can be implemented with Customer's Canvas.

## General idea

Let's understand how this task can be implemented in Customer's Canvas. 

First, let's organize a **product catalog**. You should create the following items:

- Products (e.g. mugs, tumblers, etc.)
  - Options (e.g. color, material, etc.)
    - Variants (combinations of all option values with assigned SKUs)

You may connect the **preview mockup files** created in Adobe Photoshop to each variant. You may have more than one mockup for each combination of options, for example, a product image pictured from different angles.

Your POD system should also have a catalog, which may mirror the structure in Customer's Canvas or be more complex. The key is ensuring you can link variants in Customer's Canvas with yours using SKUs.

Creating a product image is straightforward:

1. Identify the product variant in your system.
2. Determine its corresponding SKU.
3. Use the SKU to find the corresponding product and variant in Customer's Canvas.
4. Identify connected mockups for this variant.
5. Populate the mockup's smart object with your chosen image — either user-uploaded or stored in Customer's Canvas.

Now, let's explore the implementation of each task in detail.

## Configuring data in Customer's Canvas

### Organizing a catalog

The first thing you need to do to achieve our goal is organize a catalog of the products. 

In Customer's Canvas, you can create the products (e.g., mugs, T-shirts, etc.), add options (e.g., model, color, etc.), configure SKUs for each variant, and associate the mockup images with the necessary options and variants. You can learn how to organize such products in the [Admin Guide](https://customerscanvas.com/docs/hub/admin-guide/pim.md) of Customer's Canvas Help Center. 

### Creating mockups in Adobe Photoshop

You may wonder how exactly to create the mockup images. Customer's Canvas supports mockups created in Adobe Photoshop, which can be multi-layered. The placeholder for the artwork is designated with a smart object. Learn more about creating mockups in the [Designer's Manual](https://customerscanvas.com/docs/hub/designers-manual/mockups/pim-mockups.md) of Customer's Canvas Help Center.

### Adding mockups to Customer's Canvas

Once you have PSD files for your mockups, you need to upload them to your Customer's Canvas account through the admin panel, as explained in the [Admin Guide > Manage Assets > Mockups](https://customerscanvas.com/docs/hub/admin-guide/manage-assets/mockups.md) section of the Help Center.

You can also manage mockups in your tenant using the [`Mockups`](https://customerscanvas.com/docs/hub/dev-center/api/asset-storage.md#tag/mockups) APIs.

### Optional — adding artwork to Customer's Canvas

Depending on your needs, you can also pre-upload the artwork added to the product images (in case it is not provided by the end user and not updated so often). The process is quite similar to the mockups, but you should use the [Images](https://customerscanvas.com/docs/hub/admin-guide/manage-assets/images.md) section instead. Also, if you prefer manipulating them through API, use the [`Images`](https://customerscanvas.com/docs/hub/dev-center/api/asset-storage.md#tag/images) API.

If you prefer to use the artwork uploaded by the customer, there is no need to upload images to the asset gallery first. This scenario will be considered later.

### Putting things together

So, let's see how you can configure a catalog of your product mockups in Customer's Canvas:

1. Create a PSD mockup of your product.
2. Upload this mockup to the **Assets** > **Mockups** section. If needed, organize the folder structure to make it easy to navigate in this section.
3. Create a product and its options. Your product model may contain only those options that determine the originality of the mockup. If your product does not have options, then it is enough to create any option with one value.
4. Establish **Asset Connections** for mockups by linking specific mockups to specific option values or their combinations.
5. Specify the SKU for each option using the same values as in your system.

![Defining product SKUs.](images/product-sku.png)

## Establishing a connection between Customer's Canvas and your system

To easily find the necessary mockups, you need to do something like publish our products in your system. Let's look at how you can implement this.

First, set up an integration describing your application in Customer's Canvas so that we can publish products there:

1. Go to **Settings** > **Integrations**.
2. Create an integration of the **Custom** type.
3. Save its name (for example, **My POD System**) and ID.

For more details, refer to the [Registering storefronts](https://customerscanvas.com/docs/hub/dev-center/api/storefront/register-storefront.md) topic.

Then, open our product and go to the **Links** tab. Create a product link on it, specifying **My POD System** as the created **Storefront** and the product ID that you use in your system for this product as a **Storefront product**.

![Creating product links.](images/product-link.png)

If your product has options, you'll probably want to find mockup variations for different combinations of options. To do this, on the **Variants** tab, specify the SKU from your system for each variation.

## Generating a preview

To begin working with the BackOffice APIs, you need to register your app in your tenant and implement the Client Credentials authentication flow, as explained in the [Authentication](https://customerscanvas.com/docs/hub/dev-center/api/auth.md) article.

You can generate a product preview through the following steps:

1. Obtain a token to access data storage with designs and mockups, using an External App.
2. Find the product linked to our mockups by passing its reference ID to the endpoint [`GET /api/storefront/v1/product-references`](https://customerscanvas.com/docs/hub/dev-center/api/storefront.md#tag/productreferences/Get) of the Storefront API. As an alternative, you can filter products by SKU through the endpoint [`GET /api/storefront/v1/products`](https://customerscanvas.com/docs/hub/dev-center/api/storefront.md#tag/products/GetAllProducts) with the additional query parameter `sku`.
3. Get the details about variants and mockups through the endpoint [`GET /api/storefront/v1/products/{id}/variant-mockups`](https://customerscanvas.com/docs/hub/dev-center/api/storefront.md#tag/products/GetProductVariantMockups) with no restrictions on variants. Its response will contain all the variants, and you will be able to implement a search through them and quickly switch between them.
4. For the obtained mockup set, call the endpoint [`POST /api/atoms/v1/images/render-preview`](https://customerscanvas.com/docs/hub/dev-center/api/design-atoms.md#tag/designatomsservice/RenderDesignPreview) to render product previews.

The following sequence diagram illustrates the process.

```mermaid
sequenceDiagram
	participant A as Your app
	participant C as Customer's Canvas
	A ->> +C : Authorization
	C -->> -A : Access token
	A ->> +C : Find a product by ID from your system
	C -->> -A : Product data
	A ->> +C : Find a variant mockup by SKU
	C -->> -A : Mockup data
	A ->> +C : Render a product image based on a mockup and URL to an artwork
	C -->> -A : Resulting product image (as a stream)
```

### Artwork sources

You can use artwork from the following sources:
- A gallery of your artwork that you upload to the **Assets** > **Images** section.
- User images that they upload to their private storage.
- Prints in an external system that can be accessed through their URLs.

To learn how these use cases can be implemented, refer to the [Rendering preview mockups](https://customerscanvas.com/docs/hub/dev-center/scenarios/product-images/rendering-preview-mockups.md) topic.