Documentation

In-App Purchasing

Client API

SDK API

In-App Purchasing

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.
Read time 4 minutesLast updated 2 days ago

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.

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 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.
  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.

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.
  • 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.
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.
  3. Publish the production environment. Refer to Publish a webshop.