Templates & Rendering

Templates & Rendering

Templates allow you to generate custom product images by overlaying your product data onto designed layouts. These rendered images can replace your original product images in the feed output.

Selecting a Template

1. On your feed detail page, find the mapping you want to add a template to.
2. Click the Select Template button in the actions column.
3. Browse available templates and click Select on the one you want.
4. A render job will automatically be queued.

Render Queue

When you select a template, a background render job starts processing all products in your mapping:

• Queued — The job is waiting for its turn (only one render runs at a time globally).
• Processing — Products are being rendered. You can track progress (e.g., “15 / 47”).
• Completed — All products have been rendered. The cached count shows how many images exist on disk.
• Cancelled — The job was cancelled (e.g., when mapping rules or filters changed).

You can cancel an active render job at any time from the render status section.

How Rendering Works

For each product, the system:

1. Applies your mapping rules to transform the product data.
2. Downloads the product’s image (if the template has image elements).
3. Renders the template as a JPEG with the product data overlaid (title, price, brand, etc.).
4. Caches the result on disk for fast serving.

Template Elements

Templates can contain three types of elements:

• Text — Displays a product field value (e.g., title, price, brand). Supports font size, color, alignment, and font family. HTML tags in product data are automatically stripped.
• Image — Displays the product image, scaled to fit the element bounds.
• Shape — Decorative rectangles and other shapes with custom colors and opacity.

Re-rendering

Render cache is automatically invalidated when:

• Mapping rules are changed.
• Filters are changed (product set changes).
• A different template is selected.
• The source feed is re-fetched with new data.

After invalidation, a “needs re-process” indicator appears, and you can start a new render job.

Cooldown Period

After a render job completes, there is a cooldown period (5 hours) before you can start another render for the same mapping. This prevents excessive server load.

Public Feed with Templates

When a template is assigned and renders are completed, the public feed URL automatically replaces product image URLs with the rendered template images. This means your sales channels will display your custom-designed product images.