Downloading and Uploading Custom Themes

These instructions are for downloading and uploading custom themes for stores that have one of our Stencil themes. For help customizing legacy Blueprint themes, see Accessing and Customizing Template Files (Blueprint).

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

 

Before you download! Customizing Stencil themes requires in-depth knowledge of web development and use of the Stencil CLI framework.  Per our Design Policy, our technical support team is unable to provide assistance with custom themes. See our developer articles for support resources.

Downloading your Stencil theme allows you to have a version of your theme downloaded onto your computer. This is required if you want to develop a custom theme using the Stencil CLI framework. Making changes to your theme in CLI gives you full access to the JavaScript files that are not available in Edit Stencil Theme Files. It also acts as a backup of your current theme set up. 

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 Advanced drop-down of the current theme or the Action Icon on an inactive theme.
Advanced Drop-Down Menu

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

Download current theme* — downloads any edits you have made in Theme Editor and currently have live on your store
Download Saved Theme — downloads the most recent edits you have made in Theme Editor but is not live on your store 
Download Original Theme — downloads the default theme without any edits made in Theme Editor

This option will only appear in the dropdown menu if you are downloading a theme that is currently live on your storefront.

3. Save the .zip file to your computer. You need Stencil CLI framework to unzip the file. 

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. For specifics on unzipping downloaded themes and working with them, see the Download a Theme section.

 

Important! 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. This includes any themes created via Make a Copy
  • 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 using Stencil CLI framework.
  • 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 Design › My Themes.

2. Click the Upload Theme button by the My Themes heading below the Current Theme.

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 Design › My 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) that you have uploaded or copied can be renamed.

3. Click the Action Icon to see the drop-down, then click Rename.

Rename Option

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 Design › My 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 Action Icon drop-down, then click Delete.

Delete Option

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.

Related Articles

Additional Resources

Go to My Themes in my store

Was this article helpful?