# Fox in the Builder

> Ask Fox to change your store's pages, generate sections and pictures, translate the store, build a store from a link, and write product copy.

Fox is Workstation's AI assistant. In the [store builder](https://workstation.repzo.com/docs/online-store/store-builder) it works on your site like a teammate: it reads the page you're on, changes sections, adds new ones, adjusts the theme, and writes or translates text.

Everything Fox does in the builder goes into your **draft**. Shoppers see nothing until you [publish](https://workstation.repzo.com/docs/online-store/themes). Each change Fox makes is one undo step, so **Undo** (or `Ctrl`/`⌘` + `Z`) takes it back like any of your own edits.

AI features use your [AI balance](https://workstation.repzo.com/docs/commerce/ai-balance). Generating pictures, translating the store, store from a link, and the product AI tools are switched off in [sandboxes](https://workstation.repzo.com/docs/administration/sandboxes).

## Open Fox

In the builder, click the **AI assistant** button in the top bar, or press `F`. Fox opens in a side panel next to the preview.

Fox keeps a separate conversation for each site and theme, so opening it in the builder never continues an unrelated chat.

### What Fox is talking about

Whatever you have selected travels with your message as a chip in the composer:

- a selected **section** or **block**, by its name (for example "Image banner");
- nothing selected: the **page** on screen.

So "make this shorter" or "use a darker background here" changes exactly that item. Click the chip to jump back to the item. Remove the chip with **×** if your request is about something else.

### Following along

While Fox works, the panel shows one status line ("Working on it", then what it's doing), and the item it's changing glows in the section list and in the preview. When it's done, the changes are grouped in one **Store changes** card that lists, in plain words, what changed.

## Ask AI on the canvas

You don't have to open the panel to ask for a small change:

1. Click a section or block in the preview.
2. In the floating toolbar, click **Ask AI**.
3. Type what you want in **Ask for changes…** and press `Enter`.

The toolbar shows Fox's progress ("Thinking…", then the step it's on). Click **Stop** to cancel. When it finishes you can type **Add follow-up instructions…** for another round, or click **Open in chat** to continue in the Fox panel.

The same request is also in the settings panel: open the **⋯** menu on a section or block and choose **Ask AI to change it**.

## What Fox can change

| Change | Asks for approval? |
|---|---|
| Edit, add, move, and remove sections and blocks | No (draft only) |
| Change theme settings | No (draft only) |
| Generate a custom AI block or section | No (draft only) |
| Generate a picture for the site | No (draft only) |
| Translate the store | No (draft only) |
| Write and delete [theme code files](https://workstation.repzo.com/docs/online-store/edit-code) | No (draft only) |
| Add a [starter template](https://workstation.repzo.com/docs/online-store/sites) as a new, unpublished theme | No |
| Create or change collections, menus, and content entries | Yes |
| Create discounts | Yes |
| Import products from a link, write product copy, generate product photos | Yes |

Draft edits don't ask because nothing reaches shoppers until you publish, and versions are kept. Changes to live data such as menus, collections, discounts, and products show an approval card first. Admins can change which tools Fox may use and which need approval on Fox's page in [AI Agents](https://workstation.repzo.com/docs/operations/ai-agents).

Fox acts with your permissions. To change the site you need `commerce.manage`.

## Generate a section or block

The **Add section** and **Add block** pickers have a **Generate** option at the top:

1. Click **Generate**.
2. Describe what you want in **Describe what you want to build**, or pick one of the suggestions (for example "A countdown to our next sale with a copy-code button").
3. Press `Enter`.

Fox builds it in the background while you keep editing. The sidebar says **Working on it**, and you see "Your section is ready." (or "Your block is ready.") when it lands. Prefer a conversation? Click **Chat with AI instead** to send the same request to the Fox panel.

The result is an **AI block**: its own layout, styles, and settings fields. It can use safe ready-made interactions such as tabs, accordions, carousels, countdowns, copy buttons, reveal-on-scroll, and full-screen pictures, but no code runs on your store. To change it later, select it and type in **Follow up instructions** in its settings.

## Generate an image

Image fields in the builder have a **Generate image** button:

1. Describe the picture in **Description**.
2. Choose the **Shape**: Square, Landscape, Wide, or Portrait.
3. Click **Generate**.

The picture is saved to your site's images and uses your AI credit.

## Translate the store

For stores with more than one language, choose **⋯ → Translate store** in the top bar. Fox fills the other language from the default one across every page: sections, AI blocks, image descriptions, page titles, SEO, and the store's built-in words. Brand and product names stay as they are.

1. Choose **Only what's missing** or **Everything** (which replaces translations you already have).
2. Check the **Estimated cost** and how much AI balance you have left.
3. Click **Translate**.

It runs in batches with a progress bar; **Stop** keeps what was already translated. The whole translation lands as one change, so a single undo reverts it.

## Store from a link

When you [create a site](https://workstation.repzo.com/docs/online-store/sites), you can fill in **Start from a website or Instagram link**. The button changes to **Create and build with AI**, and the builder opens with two things running at once:

- **Fox designs the store**: colors, fonts, words, and pictures for the theme and home page, taken from your link.
- **Store from your link** (a panel in the builder) brings your content over.

The panel shows each step:

| Step | What happens |
|---|---|
| **Read your site** | Shopify and WooCommerce stores are read from their public catalog. Other websites are read page by page, with one AI pass to pick out products and details. Names, prices, and pictures must appear on the page, or they're dropped. |
| **Products, as drafts** | Up to 100 products, with up to 6 photos each. They're added as **drafts**, so they're not on sale anywhere until you review and activate them. |
| **Policies** | A page for each refund, shipping, privacy, or terms policy the site has and your store doesn't. |
| **Contact page** | Your address, hours, phone, email, and WhatsApp. |
| **Footer menu** | Links to the new policy pages, only while the store isn't open to shoppers yet. |

Pages you already have are never overwritten, and running it again skips products that were already imported. The panel lists anything to check, such as prices in a currency you haven't added, products without a price (added at 0), or the 100-product limit (import the rest from [Data Import and Export](https://workstation.repzo.com/docs/administration/data-import-export)). Click **Review products** when it's done.

Instagram often refuses to be read. If that happens, describe your brand to Fox instead.

> **Note**
>
> Developers can start the same import from the CLI with `repzo store import`. See [Build a store from the CLI](https://workstation.repzo.com/docs/developers/online-store/cli).

## Product copy and photos

The product form has two AI helpers (see [Products and Collections](https://workstation.repzo.com/docs/online-store/products-and-collections)):

- **Write with AI** writes the title, description, search engine listing, and photo alt text, in English or Arabic, from the product's details, photos, and your **Notes for the AI**. It never invents specs, prices, or claims: where it needs a fact you didn't give, it leaves a gap in `[brackets]` for you to fill. Nothing is saved until you save the product.
- **Generate image** makes a new picture from one of the product's own photos, in a **Studio**, **Lifestyle**, or **Custom** setting. It needs a real photo first, so shoppers see the real product.

To write for many products at once, select up to 50 in the products list and click **Write descriptions**. These are saved straight to the products; any text that would need a missing fact is skipped rather than saved with gaps.

## Related pages

- [Store Builder](https://workstation.repzo.com/docs/online-store/store-builder)
- [Themes and Publishing](https://workstation.repzo.com/docs/online-store/themes)
- [Edit Code](https://workstation.repzo.com/docs/online-store/edit-code)
- [Sites and Templates](https://workstation.repzo.com/docs/online-store/sites)
- [AI Agents](https://workstation.repzo.com/docs/operations/ai-agents)
- [AI Balance and Packs](https://workstation.repzo.com/docs/commerce/ai-balance)
