When submitting your theme to the Shopify Theme Store, follow these guidelines when submitting your theme and writing your Shopify Theme Store listing page.

## Theme zip file

The first step to submitting your theme is uploading the theme ZIP file. Be sure to test your theme on your development store before you submit it to the Theme Store.

You can package the zip file using the [Shopify CLI](/docs/storefronts/themes/tools/cli/cli-2/commands) with the following command:


```
shopify theme package
```


A ZIP validator assesses the contents of your .zip file, including the following:

* the name of the theme as specified, in the `theme_name` attribute the `settings_schema.json`
* the name and number of the styles included in your theme

You can’t change the theme name after uploading, so ensure that you follow the [naming guidelines](/docs/storefronts/themes/store/requirements#naming-themes).

## Theme review notes

Describe the type of merchant that your theme is built for, and how the features of this theme help merchants to be successful in engaging and converting customers. This information isn’t shown directly to merchants, but helps our reviewers understand your goals for the theme, and it helps our operations team curate themes for collections and recommendations for specific merchant segments.

## Theme review instructions

Provide instructions for testing your theme. Include any special setup that's required, such as admin settings. List the IDs and passwords for the demo stores so that reviewers can easily see and test the theme customization settings. Provide instructions on how to find the main features of your theme.

## Theme price and value proposition

### Theme price

You can price your theme from $100 USD to $500 USD in increments of $10. Gage the amount of settings, level of design, size of the catalog it's built for, and the amount of development it took to build your theme, and then price your theme accordingly. Make sure to include the cost of providing high quality support when considering how to price your theme. You'll be expected to provide bug fixes and to answer questions about your theme. The quality of support you provide can affect how merchants rate your theme.

### Theme tagline

This is a one-line advertisement for your theme, using 70 characters or less. Taglines should be short, succinct, and they should sum up what makes your theme unique. Effective approaches to writing theme taglines are:

* Identify the unique purpose of the theme. For example, "Designed for your crowdfunding campaign" or "Tailor-made for modern apparel stores".
* Describe the style and benefit of the theme. For example, "A minimalist theme that puts your photography front and center" or "An editorial-inspired design that’s perfect for publishers".
* Avoid using the tagline to describe specific theme features.
* Avoid using technical words that might not be clear.
* Avoid overt uses of marketing language such as "world’s best", or overusing adjectives such as "stunning" or "amazing".

### Metadata description

The metadata description is used by external search, and is shown in search engine results and link previews. Include keywords that are relevant to your theme to help with SEO, but ensure that your description is still readable. Use grammatical sentences rather than a string of keywords.

### Industry fit

While themes can be customized for most merchant needs, select the types of businesses your theme works best for with minimal customization.

For example, if your theme includes features that are usually required by stores in a particular industry, then select that industry. Themes are included in industry collections based on your selections, and recommendations are made based on matches between theme industry and merchant industry data.

The following is the list of industries that you can select from for this field.

<table>
  <thead>
     <tr>
        <th scope="col">Industry</th>
        <th scope="col">Definition</th>
     </tr>
  </thead>
  <tbody>
     <tr>
        <td>Art and entertainment</td>
        <td>arts & crafts supplies, collectibles, musical instruments, party supplies, etc.</td>
     </tr>
     <tr>
        <td>Business equipment and supplies</td>
        <td>safety equipment, laboratory supplies, medical equipment, food service supplies, signage, etc.</td>
     </tr>
     <tr>
        <td>Clothing and accessories</td>
        <td>clothing, jewelry, accessories</td>
     </tr>
     <tr>
        <td>Electronics</td>
        <td>computers, computer accessories, printers, mobile phones, mobile phone accessories, cameras, etc.</td>
     </tr>
     <tr>
        <td>Food and drink</td>
        <td>food, beverages, restaurants, meal kits, etc. </td>
     </tr>
     <tr>
        <td>Hardware and automotive</td>
        <td>vehicle parts and building materials, plumbing fixtures, power & electrical supplies, tools, etc.</td>
     </tr>
     <tr>
        <td>Health and beauty</td>
        <td>first aid, cosmetics, hair care supplies, shaving & grooming supplies, etc.</td>
     </tr>
     <tr>
        <td>Home and garden</td>
        <td>bathroom accessories, home decor items, household appliances, household supplies, kitchen & dining items, lawn & garden items, lighting, linens & bedding, etc.</td>
     </tr>
     <tr>
        <td>Pet supplies</td>
        <td>pet food, pet toys, pet accessories, etc.</td>
     </tr>
     <tr>
        <td>Sports and recreation</td>
        <td>sports equipment, exercise equipment, etc.</td>
     </tr>
     <tr>
        <td>Toys and games</td>
        <td>toys and games</td>
     </tr>
  </tbody>
</table>


### Catalog size

Optionally, select whether your theme is best suited for small or large catalog sizes. If you didn’t design the theme with a specific catalog size in mind, you can leave this field blank and your theme listing will show **Any catalog size**. However, recommendations and search results will be driven by selecting a value, but not by leaving the selection blank. For example, merchants looking specifically for themes suited to small product catalogs will be shown themes that are identified as such.

### Target audience

Optionally, select a maximum of three merchant segments or product types that your theme is particularly well suited for. The target audience is used to help merchants discover and focus on themes that were built with their own business niche in mind. For example, you can specify that you built your theme for merchants who sell in person, or merchants who have members-only stores.

If you're not able to tag your theme to the merchant segment that you're targeting using the available options in our list, then you can also use the listing’s meta description to help target the right merchants.

## Styles and demo stores

### Demo store url

A separate form section is generated for each style that's included in your theme ZIP file. For each style, provide a link to a complete and fully functioning demo store that uses that style. Ensure that your demo stores meet Shopify’s [demo store requirements](/docs/storefronts/themes/store/requirements#demo-stores) before linking.

### Industry shown in demo store

Select the industry represented in the images in your demo store. The value that you select is used to categorize themes as belonging to a particular set of industries. The categorization system doesn't rely on the images in demo stores, but is based on the features included in your theme.

### Demo store meta description

Optionally, provide a meta description that's specific to this demo store. If you leave this field blank, then the theme-level meta description is used.

### Demo store setup instructions

Optionally, provide a link to instructions for recreating the look and feel of your demo store. Merchants often want to recreate the design choices they see in the demo store.

### Style accent color

Specify a hex code for the background color to use on the theme listing page. This background color appears behind screenshots of each theme style. The hex code that you provide will be given a lighter opacity to ensure proper contrast and readability for all headlines, text, and buttons.

### Demo screenshots

For each demo, provide one mobile and one desktop screenshot of the home page.

Screenshot requirements:

* Desktop screenshot dimensions must be 1000px by 1248px.
* Mobile screenshot dimensions must be 750px by 1334px.
* Provide alt text for all images for accessibility and to improve SEO.
* Don’t include desktop backgrounds, added text, and browser windows in your screenshots. Crop them so that your images aren’t cluttered and don’t distract merchants from your theme.
* Your mobile screenshots can't be duplicates of your desktop screenshots.


## Key highlights

Include three highlights that differentiate your theme for merchants. Your first highlight can be a video or a still image.

**Video guidelines:**

* Use videos to help showcase interactive or animated aspects of the theme, or versatility in theme setup that can’t be expressed in screenshots.
* Don’t use video for onboarding or tutorials. Save those for your theme documentation.
* Recommended length of a video is 2 minutes or less.
* Don't use the Shopify logo or name in your video.
* The video must be hosted on YouTube. You can [turn off comments](https://support.google.com/youtube/answer/9482556) and [set your video to unlisted](https://support.google.com/youtubecreatorstudio/answer/6302665) to prevent unwanted monetization or replies.
* You need to provide the embed URL for the video, for example, `https://www.youtube.com/embed/<video ID>`.

    To find the embed URL:

      - Click the **Share** tab of your YouTube video.
      - Click **Embed**.
      - Copy the `src` attribute from the iframe tag.

**Static image guidelines:**

* Provide a title (maximum 30 characters) and description (maximum 140 characters).
* Don’t use the Shopify logo or name in your images.
* Image dimensions must be 1600px by 1200px.
* Don't use animated gif images.


## Theme features

### Look and feel attributes

The look and feel attributes describe the visual design features of your theme. Although themes can be customized to fit most merchant needs, select the attributes that describe your theme with minimal customization. Look and feel attributes can describe the types of imagery that the theme uses, the intended customer experience, or the design aesthetics, among other things.

The look and feel values attributes are optional. If your theme doesn't match any of the available attributes, then you can leave them blank. However, this data allows the grouping of aesthetically similar themes, so that when merchants are exploring one theme, they can also look at and compare with themes that share similar design features.

### Features

Select the features that your theme supports without needing additional code. Having features that are associated with a particular industry or business type helps your theme rank higher in relevant categories and recommendations for merchants. However, to make setup easier for merchants, your theme should only contain the features that are most useful to your target merchant segment.

<table>
  <thead>
     <tr>
        <th scope="col">Category</th>
        <th scope="col">Feature tag</th>
        <th scope="col">Description</th>
     </tr>
  </thead>
  <tbody>
     <tr>
        <td colspan="3"><b>Merchandising</b></td>
     </tr>
     <tr>
        <td rowspan="7">Image display</td>
        <td>high resolution images</td>
        <td>Theme is optimized for high quality, large images</td>
     </tr>
     <tr>
        <td>image galleries</td>
        <td>Display multiple images at once in a thumbnail grid or tiled mosaic-style layouts</td>
     </tr>
     <tr>
        <td>image hotspot</td>
        <td>Tag images with interactive hotspots for popups or additional information</td>
     </tr>
     <tr>
        <td>image rollover</td>
        <td>Show different images or info when hovering over an image</td>
     </tr>
     <tr>
        <td>image zoom</td>
        <td>Allow close-up view of images</td>
     </tr>
     <tr>
        <td>lookbooks</td>
        <td>Display a portfolio of images that feature a product line or collection</td>
     </tr>
     <tr>
        <td>slideshow</td>
        <td>Display multiple images one at a time in a carousel</td>
     </tr>
     <tr>
        <td rowspan="8">Product details</td>
        <td>color swatches</td>
        <td>Display color options for a product on the product page</td>
     </tr>
     <tr>
        <td>ingredients/nutritional information</td>
        <td>Show an ingredients list or nutritional information for a product</td>
     </tr>
     <tr>
        <td>product options</td>
        <td>Show available product options such as finishes, brands, or colours on collection pages</td>
     </tr>
     <tr>
        <td>product tabs</td>
        <td>Present product details across multiple tabs or sheets on the product page</td>
     </tr>
     <tr>
        <td>product videos</td>
        <td>Include a video on the product page</td>
     </tr>
     <tr>
        <td>shipping/delivery information</td>
        <td>Show information such as shipping options and estimated delivery time</td>
     </tr>
     <tr>
        <td>size chart</td>
        <td>Display a size chart for products</td>
     </tr>
     <tr>
        <td>usage information</td>
        <td>Show usage information for a product</td>
     </tr>
     <tr>
        <td>Visual effects</td>
        <td>animation</td>
        <td>Include animations, such as page transitions, scrolling, or animated cart actions</td>
     </tr>
     <tr>
        <td colspan="3"><b>Marketing and conversion</b></td>
     </tr>
     <tr>
        <td rowspan="6">Conversion optimization</td>
        <td>cross-selling (complete the look)</td>
        <td>Show products commonly purchased together</td>
     </tr>
     <tr>
        <td>quick view</td>
        <td>View product details in a popup without leaving the current page</td>
     </tr>
     <tr>
        <td>recently viewed</td>
        <td>Show products that a visitor has recently looked at</td>
     </tr>
     <tr>
        <td>recommended products</td>
        <td>Show products based on customer behavior or past purchases</td>
     </tr>
     <tr>
        <td>stock counter</td>
        <td>Show current stock levels for a product</td>
     </tr>
     <tr>
        <td>store locator</td>
        <td>Provide map or direction to physical location</td>
     </tr>
     <tr>
        <td rowspan="2">Email capture</td>
        <td>back-in-stock alert</td>
        <td>Prompt to collect email info for notifying when product is back in stock</td>
     </tr>
     <tr>
        <td>customizable contact form</td>
        <td>Create a custom contact form with additional fields and content</td>
     </tr>
     <tr>
        <td rowspan="8">Promotional content</td>
        <td>blogs</td>
        <td>Use advanced blogging features such as surfacing blog posts on product and collection pages, or support for muliple blogs and reader comments</td>
     </tr>
     <tr>
        <td>event calendar</td>
        <td>Show a feed or calendar of upcoming events</td>
     </tr>
     <tr>
        <td>in-menu promos</td>
        <td>Embed images and promotional content into your navigation</td>
     </tr>
     <tr>
        <td>press coverage</td>
        <td>Highlight media coverage and press mentions</td>
     </tr>
     <tr>
        <td>product badges</td>
        <td>Add stickers or labels to product images to highlight sales, new items, top sellers, or other product features</td>
     </tr>
     <tr>
        <td>promo banners</td>
        <td>Add a banner announcing sales, discounts, or events</td>
     </tr>
     <tr>
        <td>promo popups</td>
        <td>Add a popup announcing sales, discounts, or events</td>
     </tr>
     <tr>
        <td>promo tiles</td>
        <td>Add custom promo elements alongside product images</td>
     </tr>
     <tr>
        <td rowspan="4">Trust/social proof</td>
        <td>age verifier</td>
        <td>Require age verfication before purchase or entering the site</td>
     </tr>
     <tr>
        <td>FAQ page</td>
        <td>Provide an FAQ page to answer visitor questions about anything from returns to shipping</td>
     </tr>
     <tr>
        <td>product reviews</td>
        <td>Automatically integrate with Shopify Product reviews app and display reviews on product pages</td>
     </tr>
     <tr>
        <td>trust badges</td>
        <td>Display badges indicating secure payment and checkout</td>
     </tr>
     <tr>
        <td colspan="3"><b>Cart and checkout optimization</b></td>
     </tr>
     <tr>
        <td rowspan="6">carts and checkout</td>
        <td>cart notes</td>
        <td>Allow customers to add notes to their order</td>
     </tr>
     <tr>
        <td>gift wrapping</td>
        <td>Allow customers to select gift wrapping as part of their order</td>
     </tr>
     <tr>
        <td>in-store pickups</td>
        <td>Allow customers to select a local pickup option instead of delivery</td>
     </tr>
     <tr>
        <td>quick buy</td>
        <td>Allow customers to add products to the cart without leaving the page</td>
     </tr>
     <tr>
        <td>slide-out cart</td>
        <td>Make cart accessible from any page</td>
     </tr>
     <tr>
        <td>sticky cart</td>
        <td>Keep add to cart button visible as customers browse and scroll</td>
     </tr>
     <tr>
        <td colspan="3"><b>Product discovery</b></td>
     </tr>
     <tr>
        <td rowspan="8">Navigation and filtering</td>
        <td>back-to-top button</td>
        <td>Provide a button that takes customers to the top of the page. </td>
     </tr>
     <tr>
        <td>breadcrumbs</td>
        <td>Show a set of links that tells the customer where they are in the site and allows them to return to a previous page</td>
     </tr>
     <tr>
        <td>collection page navigation</td>
        <td>Provide navigation menu or sidebar links on collection pages</td>
     </tr>
     <tr>
        <td>enhanced search</td>
        <td>Enable predictive or smart searching </td>
     </tr>
     <tr>
        <td>infinite scroll</td>
        <td>Continuously load content at the bottom of a page so that customers don't have to click to the next page</td>
     </tr>
     <tr>
        <td>mega menu</td>
        <td>Configure menu navigation that provides multi-column drop-down navigation</td>
     </tr>
     <tr>
        <td>product filtering and sorting</td>
        <td>Allow customers to filter products on the collection page by features such as size, color, or brand</td>
     </tr>
     <tr>
        <td>sticky header</td>
        <td>Provide a header that's visible in the same position as customers scroll down a page</td>
     </tr>
     <tr>
        <td rowspan="2">Product highlights</td>
        <td>recently viewed</td>
        <td>Allow customers to see a set of products that they recently viewed</td>
     </tr>
     <tr>
        <td>recommended products</td>
        <td>Provide a set of recommended products that are associated with the product page or collection that a customer is currently looking at</td>
     </tr>
  </tbody>
</table>

### Stores using your theme

After your theme is published and you've made some sales, then you can optionally provide URLs and screenshots of some of the shops that use your theme, up to a maximum of five stores. These examples can help showcase your theme in use.

Make sure that you have permission to feature these stores on your listing. Make sure to check on these stores occasionally, as stores can change or become inactive over time.

Screenshot guidelines:

* Image dimensions must be 779px by 1000px.

The following types of stores can't be used to showcase samples of your theme:

* adult product stores
* stores with violent or hateful content
* stores selling restricted substances
* any stores that don’t meet our [Terms of Service](https://www.shopify.ca/legal/terms-payments-us) standards

## Tracking and analytics

Get data on visits to your page.

### Google analytics code

To track page views for your theme listing using Google Analytics 4, enter your measurement ID. Learn more about [tracking your listing traffic](https://support.google.com/analytics/answer/1008080?hl=en#zippy=%2Cin-this-article).

#### Full-funnel theme install attributions

To provide full details of the theme installation funnel, the Shopify Theme Store uses [Google Analytics 4's Measurement Protocol](https://developers.google.com/analytics/devguides/collection/protocol/ga4) for server-side events, on theme installation on purchase. To receive these events, you must use Google Analytics 4 with your theme listing, and have entered an API secret generated in the Google Analytics UI.

The following events are sent to Google Analytics and display in the real-time view. However, event parameters might take up to 24 hours to propagate and need to be added as an [event-scoped custom dimension](https://support.google.com/analytics/answer/10075209?hl=en#zippy=%2Ccreate-an-event-scoped-custom-dimension%2Ccreate-a-custom-metric%2Canalyze-an-event-scoped-custom-dimension).

<table>
 <caption>Events sent to Google Analytics</caption
  <tr>
    <th scope="col">Event name</th>
    <th scope="col">Parameters</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td><code>shopify_theme_install</code></td>
    <td>
      <ul>
        <li><code>shop_id</code></li>
        <li><code>handle</code></li>
        <li><code>style_handle</code></li>
        <li><code>shop_name</code></li>
        <li><code>shop_url</code></li>
      </ul>
    </td>
    <td>Sent when a merchant finishes purchasing and installing a theme</td>
  </tr>
</table>

To generate an API secret:

1. Log into [Google Analytics](https://analytics.google.com/analytics/web/#/).
2. Click the **Admin** icon in the bottom left corner.
3. Click **Data Streams** under **Property settings**.
4. Select the measurement stream that corresponds to the **Measurement ID** which you've added to your app listing.
5. Click **Measurement Protocol API secrets**.
6. Click **Create** to generate a new API secret.

<video style="width: 100%;height: auto;margin: 40px 0;display: block;" muted loop controls>
  <source src="/assets/api/listing-in-the-app-store/google-analaytics-4-api-secret.webm" type="video/webm">
  <source src="/assets/api/listing-in-the-app-store/google-analaytics-4-api-secret.mp4" type="video/mp4">
</video>

To add the API secret to your app listing:

1. Log in to your [Partner Dashboard](https://partners.shopify.com/organizations).
2. Click **Themes**.
3. Click the name of your app.
4. Click **Edit Theme Store Listing**.
6. In the **Tracking and analytics** section, enter your Google Analyitics 4 measurement ID.
7. Enter your API secret.
8. Click **Save** to save the changes as a draft.
9. Click **Update published listing** to publish the changes.

### Google e-commerce events

To enhance tracking for e-commerce related interactions, the following events have been implemented:

<table>
 <caption>E-commerce events sent to Google Analytics</caption>
  <tr>
    <th scope="col">Event name</th>
    <th scope="col">Parameters</th>
    <th scope="col">Description</th>
  </tr>
  <tr>
    <td><a href="https://developers.google.com/analytics/devguides/collection/ga4/reference/events?sjid=2649380085872637034-NC&client_type=gtag#view_item"><code>view_item</code></a></td>
    <td>
      <ul>
        <li><code>currency</code></li>
        <li><code>value</code></li>
        <li><code>items</code></li>
        <li><code>item_id</code></li>
        <li><code>item_name</code></li>
        <li><code>price</code></li>
        <li><code>quantity</code></li>
      </ul>
    </td>
    <td>Sent when a merchant views a theme's details page</td>
  </tr>
  <tr>
    <td><a href="https://developers.google.com/analytics/devguides/collection/ga4/reference/events?sjid=2649380085872637034-NC&client_type=gtag#add_to_cart"><code>add_to_cart</code></a></td>
    <td>
      <ul>
        <li><code>currency</code></li>
        <li><code>value</code></li>
        <li><code>items</code></li>
        <li><code>item_id</code></li>
        <li><code>item_name</code></li>
        <li><code>price</code></li>
        <li><code>quantity</code></li>
      </ul>
    </td>
    <td>Sent when a merchant clicks the <strong>Try theme</strong> button</td>
  </tr>
</table>

### Google remarketing code

To add Google remarketing code to your theme listing, enter the number that follows `var google_conversion_id =` in the remarketing tag that you received from Google. We don't currently support specific tag remarketing lists. Learn about [Google remarketing](https://support.google.com/google-ads/answer/2453998).

### Facebook pixel ID

To add Facebook Pixel tracking to your theme listing, enter the ID number for your theme from the Facebook Event Manager. Learn about [Facebook pixels](https://www.facebook.com/business/help/952192354843755?id=1205376682832142).

## Contact and support

### Theme submission contact

Provide a contact email address for the review team to communicate with you about your theme submission. If no contact email is provided, then the business email for your partner account is used. To prevent our email messages from being caught in spam filters, add `theme-submissions@shopify.com` and `noreply@shopify.com` to your email provider's allowed address list.

### Theme review notifications

Provide an email address to notify you when a merchant reviews your theme, or when existing reviews are updated or deleted.

## Support and documentation

You're required to provide a way for merchants to get help through a [contact form](/docs/storefronts/themes/store/requirements#documentation-and-contact-forms), as well as provide a link to the [documentation for your theme](/docs/storefronts/themes/store/requirements#documentation-and-contact-forms). We encourage partners to have a CRM software such as a help desk set up to help manage merchant tickets. A contact email address isn't sufficient for the long term. See [Supporting your theme](/docs/storefronts/themes/store/requirements#supporting-your-theme) for more details about how to successfully support merchants.