Theme Store listing page

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 with the following command:

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.

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.

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.

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.

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

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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 and set your video to unlisted 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.

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.

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.

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 standards

Get data on visits to your page.

To track page views for your theme listing using Google Analytics 4, enter your measurement ID. Learn more about tracking your listing traffic.

To provide full details of the theme installation funnel, the Shopify Theme Store uses Google Analytics 4's Measurement Protocol for server-side events, like 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.

To generate an API secret:

1. Log into Google Analytics.
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.

To add the API secret to your app listing:

1. Log in to your Partner Dashboard.
2. Click Themes.
3. Click the name of your app.
4. Click Edit Theme Store Listing.
5. In the Tracking and analytics section, enter your Google Analyitics 4 measurement ID.
6. Enter your API secret.
7. Click Save to save the changes as a draft.
8. Click Update published listing to publish the changes.

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.

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.

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.

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

You're required to provide a way for merchants to get help through a contact form, as well as provide a link to the documentation for your theme. 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 for more details about how to successfully support merchants.