Lab - Uploading a Theme
Introduction
BigCommerce provides two options for uploading a theme to your BigCommerce store.
- Control Panel Upload
- Command Line Upload (used in this course)
In this lab, you will:
- Upload a theme to the Storefront
Prerequisites
- Bundled the theme into a .zip file
Step 1: Bundle and Push
- Enter the following command in CLI:
- Enter y to apply the theme to your store
- Select the theme variation you would like to apply
- Navigate to the URL of the store to view the applied theme
Command Line Upload (OAuth Required) This stencil push command allows you to both bundle and upload your theme to the store with a single terminal command and in one continuous process. The stencil push command is available only for themes that you have successfully initialized using an OAuth Token (with Themes: modify scope).
Stencil CLI is designed to display the same notifications, prompts and selection options that you would receive when using the control panel’s GUI.
Successful Upload
Upon a successful upload, you will be prompted: Would you like to apply your theme to your store at <domain>? (y/n) Any response except y or Y will be processed as “No.” You can always apply the theme later through the control panel.
Apply Which Variation?
If you chose to apply the newly uploaded theme, you will be prompted with: “Which variation would you like to apply?”
Use your arrow keys to move the selection caret/highlight to the variation you want, and then press Enter.
Stencil CLI will then confirm which variation is active on the storefront.
Automatically Apply a Variation and Pushing a Theme to Selected Channels
- To push a theme and activate a particular variation without being prompted, use
stencil push -a VARIATION_NAMEwith the name of the variation. - To push a theme and apply it to selected channels, use
stencil push -a -c 123 456. To apply a theme to all available channels, usestencil push -a -allc.
