# Placeholders Reference

Use these placeholders in Import Presets, Custom Prompts, Prefill Tools, and Custom Fields.

{% hint style="warning" %}
**Note:** Not every product includes all fields—availability depends on the source data.
{% endhint %}

### Special Placeholders

* `%PRODUCT%`\
  The entire product object in JSON format, including:
  * `title`
  * `description` (long description truncated to 3000 characters)
  * `price`
  * `userRating`
  * `userReviewsCount`
  * `specifications`
* `%PRODUCT.specifications%`\
  All product specifications as a list of attributes.
* `%PRODUCT.userReviews%`\
  All product reviews, truncated and optimized for use in AI prompts.
* `%PRODUCT.ATTRIBUTE.attribute-name%`\
  The value of a single specification or custom attribute.\
  \&#xNAN;*Example:* `%PRODUCT.ATTRIBUTE.color%`
* `%RANDOM(x,y)%`\
  A random integer between `x` and `y`.\
  \&#xNAN;*Example:* `%RANDOM(1,10)%`

### Standard Product Fields

**Identification**

* `%PRODUCT.unique_id%` — Internal product ID
* `%PRODUCT.module_id%` — Source module identifier

**Title & Descriptions**

* `%PRODUCT.title%`
* `%PRODUCT.subtitle%`
* `%PRODUCT.group%`
* `%PRODUCT.description%`
* `%PRODUCT.short_description%`

**Media**

* `%PRODUCT.img%` — Main image URL
* `%PRODUCT.logo%` — Merchant logo URL

**Links & Domain**

* `%PRODUCT.url%` — Affiliate/CPE link
* `%PRODUCT.orig_url%` — Original product URL
* `%PRODUCT.domain%` — Merchant domain

**Category & Merchant**

* `%PRODUCT.category%`
* `%PRODUCT.merchant%`
* `%PRODUCT.manufacturer%`

**Pricing & Savings**

* `%PRODUCT.price%`
* `%PRODUCT.priceOld%`
* `%PRODUCT.currency%`
* `%PRODUCT.currencyCode%`
* `%PRODUCT.percentageSaved%`
* `%PRODUCT.promo%` — Promotional text or label
* `%PRODUCT.shipping_cost%`

**Ratings & Reviews**

* `%PRODUCT.rating%` — Average rating (integer)
* `%PRODUCT.ratingDecimal%` — Average rating (decimal)
* `%PRODUCT.reviewsCount%`
* `%PRODUCT.userReviews%`

**Availability & Timing**

* `%PRODUCT.availability%`
* `%PRODUCT.last_update%`

**Identifiers**

* `%PRODUCT.ean%`
* `%PRODUCT.upc%`
* `%PRODUCT.sku%`
* `%PRODUCT.isbn%`

**Badges**

* `%PRODUCT.badge%`
* `%PRODUCT.badge_color%`

**Special**

* `%PRODUCT.keyword%`