Downloading and Uploading Custom Themes

These instructions are for downloading and uploading custom themes for stores that have opted into our new Stencil theme experience. For help customizing Blueprint themes, see Accessing and Customizing Template Files (Blueprint).

The BigCommerce Marketplace allows you to download the source files to customize themes available in your My Themes section.
 

Before you download! Customizing Stencil themes requires in-depth knowledge of Web development and use of the Stencil CLI framework.  Due to our Design Policy, our technical support team is unable to provide assistance with custom themes. We are unable to support future feature releases and enhancements. Check our developer article for support resources.

Downloading a Theme

After you purchase a Stencil theme (or acquire a free theme), it's available in Storefront Design My Themes. From there, you can download the theme and customize it:

1. Under My Themes, click on the thumbnail image of the theme you want to download.
Current Theme

2. Click on Theme Options to display the Download button.

Download Option

3. Save the .zip file to your computer.

Customizing the Downloaded Files

Making customizations to Stencil themes requires the use of the Stencil CLI framework. This requires in-depth knowledge of Web development. For installation details, please see the Stencil CLI developer documentation, starting here. For specifics on unzipping downloaded themes and working with them, see this section.

 

Be Aware! While you are free to customize and change the code for your own store, the original creators of the theme retain the rights to the theme. You must not upload the customized theme to another theme marketplace or sell it privately.

Custom Theme Upload Requirements

  • A maximum of 20 custom themes may be uploaded to the My Themes section of Store Design.
  • Custom themes can be deleted to make room for more uploads if you reach your max.
  • Custom themes must be archived and uploaded in ZIP file format.
  • Custom theme ZIP files must be equal to or less than 50MB in file size.
  • For a complete list of upload requirements, error codes and warnings, check our developer support article on Uploading a Custom Theme.

Uploading a Custom Theme

1. Go to Storefront DesignMy Themes.

2. Click the Upload Theme button.

Upload Theme button at the top of the My Themes section

3. Drag the ZIP file into the Upload Theme pop-up window, or you can Select theme from your computer.

Area to drag your ZIP file into, and a button to select a ZIP file from your computer

4. Once the ZIP file has uploaded, a theme card will appear under My Themes showing theme processing progress. Click Cancel if you want to halt processing and start over.

A theme card will appear showing the progress in processing the new custom theme

5. After processing, a new custom theme card will appear under My Themes. If your theme was unable to be successfully processed, you will be presented with a screen detailing any errors encountered. Ensure your theme meets all the custom theme upload requirements.

A custom theme card under My Themes

Renaming a Custom Theme

1. Go to Storefront DesignMy Themes.

2. Under the My Themes heading, click the theme you want to rename. Only non-active themes (themes not currently applied to your store) can be renamed.

3. Click the Theme Options drop-down, then click Rename.

Rename option under the Theme Options dropdown

4. In the Rename your theme pop-up window, enter the new name for your theme, then click Rename Theme.

5. You will be returned to the Store Design main screen with a message that the theme was successfully renamed.

Deleting a Custom Theme

1. Go to Storefront DesignMy Themes.

2. Under the My Themes heading, click the theme you want to delete. Only non-active themes (themes not currently applied to your store) can be deleted.

3. Click the Theme Options drop-down, then click Delete.

Delete option under the Theme Options dropdown

4. In the You are about to delete your theme pop-up window, confirm you want to the delete the theme by clicking Delete Theme.

5. You will be returned to the Store Design main screen with a message that the theme was successfully deleted.

Was this article helpful?