---
title: "Preview"
method: POST
path: "/companies/{company_id}/templates/{template_id}/preview"
tags: ["creatives"]
---

# Preview

`POST /companies/{company_id}/templates/{template_id}/preview`

## Request

- Base URL: `https://app.zalster.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zalster.com/companies/{company_id}/templates/{template_id}/preview`
- Auth: none declared

Server-side SVG for one product: the parity reference for the editor's own render.

With ``profile`` "clean", the document's clean image instead (decision 124):
drawn from ``clean_document`` exactly as a render draws it, in any of the
three formats, with no variant and no rule set. With "lifestyle", its
lifestyle image (decision 128), in 1:1 or 4:5; ``variant`` then names which
of them (decision 138): ``default`` for the first, 2 to 5 after it.

## Path parameters

- `company_id` string, uuid, required: Company id
- `template_id` string, uuid, required

## Query parameters

- `at` string, date-time, nullable: draw as at this moment, with a time zone; now when left out
- `theme` string, nullable: none, scheduled (the default: the company's theme now) or a theme's id

## Request body

- TemplatePreviewRequest
  - `document` object, nullable
  - `product_id` string, uuid, nullable
  - `format` string
  - `variant` string
  - `profile` 'designed' | 'clean' | 'lifestyle': Which picture of a product a template makes for a channel (decision 124). ``designed`` is the template as drawn. ``clean`` is the product alone on a plain ground — what Google Shopping requires of ``image_link``, which disapproves a product whose picture carries a price, a badge, a call to action, a logo or a border. ``lifestyle`` (decision 128) is the product's approved cut-out on a vivid colour or a scene, for Google's ``lifestyle_image_link``: a picture a feed sends beside its main one, never instead of it.

## Response `200`

Successful Response

- TemplatePreviewOut
  - `product_id` string, uuid, required
  - `external_id` string, required
  - `format` string, required
  - `svg` string, required
  - `warnings` object[], required
  - `bound` object, required
  - `visibility` object, required
  - `subject_boxes` object
  - `pictures` object
  - `overrides` object
  - `conditions` object
  - `parts` object
  - `picture_findings` object[]
  - `touchups` object
  - `codes` object
  - `tables` object
  - `layout` string, nullable
  - `explain` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zalster/apis/zalster-feed-processor.md) - [All operations](https://skmtc.dev/zalster/apis/zalster-feed-processor/llms.txt) - [OpenAPI document](https://skmtc.dev/zalster/apis/zalster-feed-processor/revisions/d0b9dc66ad36?raw)