> ## Documentation Index
> Fetch the complete documentation index at: https://www.alttextlab.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# E-commerce mode

> Generate product-focused alt text using brand, color, material, and other product metadata.

E-commerce mode produces alt text optimized for product listings — emphasizing specific product attributes rather than general visual description.

## How it activates

E-commerce mode activates automatically when you include any product metadata in your request. There is no separate toggle.

**API** — include any field in the `ecommerce` object:

```json theme={null}
{
  "imageUrl": "https://example.com/sneaker.jpg",
  "ecommerce": {
    "product": "sneakers",
    "brand": "Nike",
    "color": "black",
    "material": "leather"
  }
}
```

All e-commerce integrations include metadata settings where you can select which product fields to pass. E-commerce mode activates automatically when at least one field is provided.

<Tip>
  Pass as many product fields as possible. The more context the model has — brand, color, material, product name — the more precise and consistent the output will be across your catalog.
</Tip>

## Output differences

| Mode       | Example output                                          |
| ---------- | ------------------------------------------------------- |
| Default    | *A person wearing joggers in a park, mid-stride.*       |
| E-commerce | *Black Nike joggers in polyester fabric — relaxed fit.* |

## Style interaction

When e-commerce mode is active, the selected [writing style](/features/writing-styles) has lower priority. Output stays concise and attribute-focused regardless of the style setting. This ensures consistency across product listings.

## Available product fields

| Field      | Description               | Example           |
| ---------- | ------------------------- | ----------------- |
| `product`  | Product name or type      | `"office chair"`  |
| `brand`    | Brand name                | `"Herman Miller"` |
| `color`    | Dominant color or palette | `"ivory white"`   |
| `material` | Product material          | `"ceramic"`       |