# Generate a webshop theme with AI

> Generate a webshop theme from your game's Apple App Store listing or your own images in the Unity Dashboard.

AI-assisted theme creation generates a starting theme for your webshop from your game's Apple App Store listing or images, so you don't have to design one from scratch.

This page describes how to generate, review, and publish a theme for an existing webshop. For more information on what a theme contains and how branding relates to it, refer to [Themes and branding in webshops](./theming-and-branding.md).

## Prerequisites

Before you start, make sure you meet the following prerequisites:

* An existing webshop. If you haven't created one yet, follow [Create and publish your first webshop](./create-and-publish-your-first-webshop.md) first.
* Source images for the theme: A public Apple App Store URL for your game, your own images of the game to upload, or both.

## Generate a theme

To generate a theme, follow these steps:

1. Go to the [Unity Dashboard](https://cloud.unity.com).

2. Open **Monetization** > **Webshop**.

   > **Note:**
   >
   > If you use the legacy Unity Dashboard, go to **In-App Purchases** > **Go to Webshop**.

3. Select your webshop's menu (**...**), and then select **Edit**.

4. In the environment selector, select the environment whose draft you want to change:
   * Select the production environment to change the live shop.
   * Select a non-production environment to experiment without affecting production.

5. Under **Customize theme** > **Theme generation**, provide at least one of the following sources for the theme generator:
   * Enter your game's Apple App Store listing URL in the **Store URL** field.
   * Upload screenshots of your game under **Your app images**. Images give the generator the most accurate match to your game's visual style. You can upload up to six images, each up to 2 MB.

6. Select **Generate theme**.

7. Wait for the theme to generate. The Unity Dashboard reads the source, runs the theme generator, and displays the new theme in the **Preview** pane.

When you provide a store URL, the tool uses the app icon as your webshop thumbnail. You can replace it with your own thumbnail. The images you provide, whether uploaded screenshots or images from a store listing, help define the theme's color palette and visual style. These images aren't displayed in the webshop. To learn how to set branding, such as the thumbnail, refer to [Themes and branding in webshops](./theming-and-branding.md).

## Review the generated theme

Use the **Preview** pane to check the theme against your shop's content. You can toggle between the **Current draft** (your in-progress changes) and the **Live webshop** (the version players currently see) to compare themes.

If your IAP catalog isn't connected yet, the preview shows an empty product grid. To see the theme against realistic content, expand the **Catalog & payment provider** section and enable **Mock catalog**. The **Preview** pane then shows sample products. Mock products appear only in the **Preview** pane, so players never see them.

After you review the theme, choose one of the following options:

* Save the draft: Select **Save draft** to commit the generated theme as the environment's draft. Until you save, leaving the page or regenerating discards the in-progress result.
* Refine the theme: Select **Refine with AI** to adjust the theme conversationally instead of regenerating from scratch. Refer to [Refine the theme with AI](#refine-the-theme-with-ai).
* Regenerate the theme: Change the store URL or images, then select **Generate theme** again. The new result replaces the current theme.
* Reset the theme: Select **Reset theme** to revert to the Unity default, so the next generation starts from scratch.

## Refine the theme with AI

After you generate a theme, select **Refine with AI** to adjust it through a chat instead of regenerating from scratch. The refine view puts the chat next to a live **Preview**, where you can switch between **Current draft** and **Live webshop** and preview the theme across devices and currencies.

Describe the change you want in plain language — for example, `make the background darker` or `make the buttons a warmer gold` — and the assistant edits the current theme and updates the preview. Refinement is a conversation, so you can keep iterating one change at a time:

* For some requests the assistant proposes a plan first. It describes what it intends to change and which fields it will adjust, then waits for you to select **Apply** or **Reject** before it edits the theme.
* For others it applies the edit directly and summarizes what it changed, listing the affected theme fields (for example, `colors.primary` or `zones.header.glow`). Expand **View the diff** to see every changed region.
* To undo or rate a change, select **Undo this change** on an applied change to revert it, and rate whether a change was helpful to improve future results.
* If a request doesn't map to a theme change, the assistant tells you that no visible changes were needed instead of editing the theme.

The conversation is saved for the environment, so you can return later and continue where you left off.

> **Warning:**
>
> Don't include personal, confidential, or sensitive information in a refine message, such as names, IDs, or payment details. Your prompts are sent to an AI model to edit the theme.

When you're happy with the result, save the draft, then publish it as described in the next section.

## Publish the new theme

To make theme changes available to users, publish them from the production environment. The publishing steps depend on where you generated the theme.

If you generated the theme in the production environment, publish it from production:

1. Save the draft.
2. Publish the production environment by following [Publish a webshop](./publish-a-webshop.md).

If you generated the theme in a non-production environment, apply it to production before publishing:

1. Save the draft.
2. Apply the draft to the production environment's draft. Refer to [Apply a non-production draft to production](./apply-to-production.md).
3. Publish the production environment. Refer to [Publish a webshop](./publish-a-webshop.md).
