Mogul Theme Manual

Get your bearings

New to BigCommerce?

If you're setting up a BigCommerce store for the first time, we highly recommend heading over to their site and taking a look at their support resources. From their  community forums to their documentation to their BigCommerce University video series, they have everything you need to start your ecommerce journey on the right foot. 

Here are a few articles that cover the basics of setting up a store:

The BigCommerce dashboard

This is what your dashboard will look like when you first sign up for BigCommerce. You can go just about anywhere and do just about anything from here. It can be a little overwhelming at first, which is why we recommend taking  a quick guided tour to get your bearings.

Our documentation deals primarily with customizing the content and design of your store. If you're looking at the dashboard, we'll be covering the items listed under Storefront ContentStorefront Design, and a little bit of Marketing in these docs. If you're looking for basic information on how to add products, configure categories, set shipping rates, or anything else that isn't directly related to your theme, please consult BigCommerce's documentation or contact their support centre.

Upload and customize your theme

How to upload your theme

If you've purchased your theme directly from BigCommerce, it will be automatically installed when you log into your BigCommerce dashboard. You'll find all of your themes by navigating to  Storefront Design>My Themes. Your Current Theme will display at the top, and any previously installed themes will appear below it. 

If you want to publish a theme that isn't currently installed, simply select it and click   Apply on the next screen. If you have a theme from another source besides BigCommerce, you can click Upload Theme and either drag or upload it from your computer. Once you click Apply on the following screen, it will be installed on your store.

How to select a theme style

Mogul comes with four unique theme styles that curate the fonts, colors, and general style of your store. Check out our store demos to see the  ClassicCleanWarm, and Dark styles in action.

You can change the style of your theme from the  Stencil Theme Editor. We'll dig deep into this below, but for now, all you need to know is how to navigate to it:  Storefront Design>My Themes>Customize (it's that big blue button next to your current theme).

Once you're in, select  Styles from the sidebar menu and you'll be presented with your four options. Select the one that closest matches your vision for your store, click Save Changes, and you're good to go!

Note that applying and saving a new style will overwrite your current style settings, however you will not lose any content from your store. It's always a good idea to make a backup copy of your theme before you start making customizations. 

The Stencil Theme Editor

Once you've uploaded your theme and selected a style, it's time to make it your own. While all of your products, collections, pages and marketing (including the carousel) will be configured from the BigCommerce dashboard, most of the changes you make to the look and feel of your store will happen in the Stencil theme editor. You'll access it by navigating to  Storefront Design>My Themes, and then clicking the blue Customize button under Current Theme.

You'll notice that the theme editor sidebar menu is divided into a whole bunch of sections:   HistoryStyles, Typography, Colors, Navigation, and more. We'll cover all of them — in more or less the order that you might encounter them — below.


Like the History tab on your web browser, the History section on your theme editor keeps a log of all the changes to your store since you first started building it. 

All of the entries are time stamped and include the name and version of the theme you were using. This is handy if you ever want to revert the settings on your store back to a previous version. Just select the version you want to use and click the blue  Apply Theme button in the bottom right corner.


Mogul comes with four unique theme styles that curate the fonts, colors, and general style of your store: ClassicCleanWarm, and Dark. You can preview how they will look in your store by clicking through the options in the sidebar and watching for the change.

Once you've settled on a look, click  Save Changes in the bottom right corner, and you're good to go!

Note that applying and saving a new style will overwrite your current style settings, however you will not lose any content from your store. It's always a good idea to make a backup copy of your theme before you start making customizations. 

Fonts and Colors

Mogul comes with a selection of hand-picked fonts and colors for your store. You'll find them under the first two tabs of the theme editor: Typography and Colors. You can select the Regular font, which will be used for the body text throughout your store, and a Heading font, which will be used for headings.

For colors, you're able to select the Body color, Heading color, Accent color, Background color, Footer text color, Footer Background color, Carousel text colorPromo banner text color, Promo banner background color, Banner background color and Apple pay button color.

Simply find the feature or area of your site you want to customize and click the swatch beside it. A dropdown color selector will appear, which allows you to adjust and experiment with custom colors. You can also add a hex code as a text input if you wish. This can be helpful for matching colors across your site (you can copy and paste the codes into multiple fields).

Any changes you make here will be automatically displayed in the preview.


The header is the rectangular area that runs across the top of your store above containing your logo, search, currency converter, account login and cart. It appears on every page and is intended to be used to promote your company's brand and make it easy for customers to access regularly used tools.


In Mogul, your store's navigation is located in the left sidebar and, similar to the header, will appear on every page. It is designed to make it easy for customers to root themselves and navigate your store from any page. 

There are a number of setting in the Theme Editor that allow you the appearance and function of your store's navigation.

To start off you are presented with several options of what to show in your navigation.  These settings can simply be checked or unchecked to turn on or off the display of that element in your navigation:

  • Show 'Home' Link does just that — shows a link to your homepage in your navigation
  • Show Pages means that your pages (such as Shipping & Returns, FAQ, About and Contact) will display in your navigation
  • Show Categories means that your product categories will display in your navigation (more on that below)

If that last setting is enabled, you can also customize how these categories display using Display Categories setting, found in a drop down menu below. You can opt to either show them in the main navigation (this will spell out each of your collections) or in a 'Shop' menu (this will "nest" the categories under a 'Shop' dropdown in your navigation).

Finally, you have some ability to customize the order that your navigation items appear with the Display pages first settings. Checking this setting on will do as the setting implies and, if set to show, your pages will appear as the first items in your navigation.


Like the site header, the footer is a long rectangular area that appears on every page but runs along the bottom of the site. Footers are used to display important store information, like addresses and contact information, as well as, menus featuring links to specific categories, brands and pages. 

Mogul contains a number of settings that allow you to control what information is contained in your footer:

  • First list content and Second list content give you option to choose to feature either brands, categories or pages in your footer. You can also choose to disable the list all together.
  • Show Copyright Information copyright will display a copyright mark in you footer with the year.
  • Show Theme Credits will display the Pixel Union and BigCommerce credits found right at the bottom of the footer.
  • Show Sitemap allows you to control whether a link to your store's sitemap shows in the footer. The sitemap is basically an XML file that contains a list of the URLs in your store. To customers, it looks like a page with links to all the other pages in your store:

The Sitemap also helps search engines find all the pages on your site and is important for your SEO.  Got more questions about the importance of your sitemap or about SEO in general? Checkout BigCommerce's list of   SEO Success Essentials.

Lastly, the  Payment Icons settings allows you to control which icons show at the bottom of your footer. Just check or uncheck the box next to the payment method to show or hide that particular icon.


Your homepage is made up of six basic sections:   Carousel, Featured ProductsNew ProductsPopular Products and Blog Posts. The content for these sections is pulled from your dashboard. With the exception of the carousel, the latter four sections are all optional. You can disable any of them by selecting Disabled from the Number of Products/Posts dropdown at the top of each section's settings under Homepage. Along with being able to disable the section completely, each setting also allows you to customize the number of items featured in these sections.

In web design parlance, the Carousel refers to the rotating cycle of images that generally occupies the "above the fold" area of our store (in Mogul, it's just below your header). You'll set up the "slides" for your Carousel in the BigCommerce admin under Storefront Design>Design Options>Carousel & Social Media (more on that below—or here)

The Carousel image aspect ratio setting gives you three options for controlling how your images look in your carousel: Default, 16:9 and 3:1.

The aspect ratio refers to the proportional relationship between an image's width and height and the Carousel Image Aspect Ratio setting gives you three options for controlling the aspect ratio of your carousel images:

Default: Images in your slideshow will be displayed in Mogul's default aspect ratio.  This may result in your images being cropped but fear not! This ratio was specifically chosen by our word class designers and works great on Mogul.

16:9: Sets your carousel images to a 16:9 ratio regardless of the original image size and can result in cropping.

3:1: Sets your carousel images to a 3:1 ratio regardless of the original image size and, like the 16:9 setting,  can result in cropping.

Wrapping your head around aspect ratios can be tricky. If you need a little help on the basics, check out this great article on  understanding and working with aspect ratios

Product Listing

The  Product listing settings apply to any area of your store where your products appear as a group or collection. You can customize how your product tiles display on these pages using the settings here.

First off, the Products per page setting refers to how many products appears per page in your product listings and can be set in multiples of 4.

Quick view is a pop up window that provides customer with high level details about a product and ability to add the product to their cart directly from the Quick view window. The Show Quick View setting allows you to turn this functionality on or off by hiding the Quick Look button that appears when hovering over a product.  

Similar in objective to Quick view, you can also feature an Add to Cart button for each product in your Product listings.  This Add to Cart button appears when you hover over a product and allows customers to add the item to their cart directly from the Product listing page. If any of your products have options, the button text will display Choose Options, rather than Add to Cart, and will take customers to the product page. This function allows the Add to Cart button to be available for products that require no option selection but, for those that do, directs customers to make the required choices first. 

There is no setting in the Theme Editor for the Add to Cart button but it can be turned on/off in your Control Panel under Store Settings > Display Settings > Product Settings > Show Add to Cart link?

Product Grid Aspect Ratio allows you to set the aspect ratio of your product images (i.e. the relative height and width of your images) to either 1:1, 4:5, 3:1 or 3:2. You'll notice that 1:1 is square, whereas 4:5 is a portrait-oriented rectangle and 3:2 is a landscape-oriented rectangle. Click here for a great article on understanding aspect ratios.

Note that if your product images were shot on a white background and your site background is also white, it might be difficult to tell the difference between some of these options.

Product Grid Image Cropping allows you to either Fit or Fill your product images to the size of the container.

Brands Page

These settings control the display of brands at  /brands, where all the Brands you've created in the control panel will be displayed. To manage your brands, have a look in your control panel under Products > Brands

BigCommerce automatically generates a brands page for you at  yourURL/brands (the URL for our Minimal demo is Not all stores opt to include a brands page (you wouldn't need one if you produced your own products or only sold a single brand) but if you want to, that's where it is!

The settings here allow you to  Show brand images or... not!

Optimized checkout 

Optimized checkout is BigCommerce’s new single-page checkout and order confirmation page. It includes features that reduce friction and improve the overall flow of checkout to increase sale conversions.

You can customize the look and feel of your store's checkout experience from the theme editor.

From the top, you can customize the  Background color using the color picker or inputting a hex code to match your store's design. If you want to Use (a) custom background (i.e. an image), ensure that box is checked. We recommend using a 1000 x 400px image (that optimizes it for the theme, you can Specify (other) dimensions if you wish).

You can also upload a  Custom logo to your checkout page if you don't want to use the same one as your storefront. Just select Custom from the dropdown and then choose a Position.

If you want to display a  Discount Banner on your store, you first have to create it in the BigCommerce admin under Marketing>Banners (more on how to do that below, under Marketing)

If you want to customize the  Background color of your order summary (that's the box on the right side that says "Order Summary") you can do so from the Order summary>Background color selector. 

Likewise for the  Checkout steps (Background color is the "bubble" color around the numbers; Text color is the color of the numbers themselves).

Actually the same goes for  Primary headingsSecondary headingsBody, Primary contentSecondary contentLinksPrimary buttonSecondary button, and Form inputs. There is effectively no component of the checkout experience that cannot be customized :-)

Edit Theme Files

If you have a knowledge of CSS and HTML, editing your theme files can be a great way of taking your store customizations to the next level. We're not going to go there in these docs, but if you're looking for a good primer, you'll find it   here.

Note that BigCommerce is unable to offer support for any theme that has been modified with Edit Theme Files. Proceed with caution.

Storefront Content

The  Storefront Content tab of your BigCommerce dashboard is where all of your pages, blog posts, and images live. If you're looking to create or edit a page or post, or if you want to manage the images contained in those pages and posts, this is the place to do it. 

BigCommerce has some great resources on these topics (which we've linked to below) but we wanted to supplement them with a bit of quick n' dirty setup info so you can get your store up and running (and selling) ASAP. Scroll down for Storefront Content 101.

Web Pages

The web pages on your BigCommerce store should be used to display content that doesn't change very often. Yes, your product, brand, and category pages are all technically web pages, but they are all generated and managed automatically. It's pages like your "About," "Contact" and maybe a "Size Guide" or "Return Policy" that you'll create and manage here. 

How to add a contact page

Our BigCommerce themes have a built-in Contact Page that provides customers an easy way to send a message or question to store merchants without leaving the storefront.

To create one, go to Content>Web Pages and click Create a Web Page at the top of your Pages list.

Under Web Site Link, enable the Allow people to send questions/comments via a contact form option.

Then, under  Web Page Details, enter a name for your contact page. The Page URL will auto-fill based on the page name.

You can also insert content (such as text and images) in the  Page Content area, which will appear above the Contact Form.

Now, if you navigate to that page in your store, you should see something resembling this:

Now your customers can get in touch to tell you how much they love your store!

If you want to create any other type of page, just use the radio buttons under Web Site Link and complete the fields that display below. You should be able to create most kinds of ecommere store pages (About, FAQ, Size Guide, etc.) by using the Contain content created using the WYSIWYG editor below option. You'll find more information here.

How to set up a navigation menu

Your store's navigation menu will be generated automatically from your created pages and categories.

To control which pages are displayed in your menu, go to Content > Web pages. Here, you can select and deselect pages using the check mark under Visible. You can also drag and drop your pages into the desired order.

The categories that automatically display as links on your main navigation can be controlled in the same way. Just navigate toProducts>Product Categories and under the Visible in Menu? column, you can select or deselect products as well as reorder items. The changes will automatically be reflected in your live store.

You may also find    this video on updating the links of your main navigation helpful.


Blogging can be a great tool for promoting your products and giving your store a personal touch, as well as give a boost to your site's SEO ranking.

By default, a basic blog is included on the BigCommerce platform, which you can access by navigating to  Storefront Content>Blog. Here, you'll see an index of all the posts — drafted and published — on your store's blog.

If you've yet to publish your first post — what an exciting and precious time for you! — then you won't see much here yet. You might want to start by naming your blog. Here's how:

Navigate to the  Blog Settings page by clicking the "..." button at the top of the page (between the "+" button and "Blog Visibility"). This is where you should be:

Give your blog a name in the  Blog Title field (a simple "Blog" will do) and set the URL in the Blog URL field. 

You can also enable or disable  Disqus Comments at the bottom of this page. Social Sharing is now controlled under Store Settings>Share (more on that   here). 

Create a blog post

To add a post, navigate to Content>Blog and click the + icon under the Published tab. Your screen should look like this:

Give your post a title in the  Title field, write the content in the Body field, add some images (using the toolbar icon that looks like a photo of mountains or a house or a Tetris piece), and enter the author of the blog in the Author field. You can also add tags for each post in the Tags section. To add a tag, type a tag in the Tags field, and hit Enter or the comma key to separate the tags. You can also add an optional Summary thumbnail image and set the Publication date here.

In the SEO (optional) section below, you can customize each post’s URL in the Post URL field, and specify what happens If the Post URL changes. Adding a Meta description to your posts will help improve your SEO.

Click  Save Draft to save the post without publishing to work on it later, or click Publish to publish the post immediately. Make sure your Blog Visibility is set to On on the main blog settings.

Storefront Design

The  Storefront Design section of your BigCommerce dashboard is the place to be for all of your logo, carousel, social media needs. It's also where you go if you want to change or update your theme (Storefront Design>My Themes>Customize/Upload Theme). In this section, we'll focus on the things you'll want to do to get your store up and running — and looking good.

How to set up a carousel

In web design parlance, the term "carousel" refers to the rotating cycle of images that generally occupies the "above the fold" area of your store. Mogul's carousel supports up to five images with a heading, subtitle, and call-to-action button that can link to any page within your store or an external site.   

To add images to your Carousel, go to Storefront Design>Design Options and click the Carousel & Social Media tab.

Click on  Slide 1 (or whatever slide you want really) and either drag and drop a file to the outlined area or click Select from your computer to upload an image.


Once you’ve uploaded an image, you can add a  Heading, Subtitle, and Button Text by typing in the corresponding fields at the top. Click Save when you're done.

You can set the URL for the call to action button links by either typing the link directly into the  Link field or clicking Browse to choose a  ProductCategoryBrandPage, or Blog from the Store Linker. Click Insert Link and Save.


The carousel supports JPEG, GIF, and PNG file types, but we recommend using JPEG files to ensure a balance between image quality and fast loading-time. We also recommend using images at least 1200px wide. But most importantly, you'll want to ensure your slide images are consistent in dimension.


Along with the carousel’s content, you can customize the duration that each slide appears on the screen before automatically switching to the next slide. Type the number of seconds between slide changes under the  Settings heading on the right side of the same Home Page Carousel page. Then click Save.

How to upload a store logo

Your store's logo provides branding for your site and a clickable link to return to the homepage. The logo will appear in the header of your site.

To replace your store title with a logo image, go to   Storefront Design>Design Options and then click the Logo tab.

By default, BigCommerce will display your store's name as a logo. If you're okay with this, do nothing! (Just ensure that Show text where my logo will be displayed is activated.) However, if you want to display a logo, activate the Upload a logo image from my computer option. 

Then choose the image file you want to upload under the  Logo Upload section. For Mogul, we recommend a logo image that's 230 x 100px or larger. Once your image is selected, click Upload Logo Image. It will display in the Current Site Logo section.

How to set up your social links

You can include links to your different social media accounts (e.g. Facebook, Pinterest, Instagram) on your storefront. With Mogu, these links are displayed as icons in your store's footer. By providing links to your social media accounts, you can encourage shoppers to follow you and share your business and products with their own friends and followers. 

To set up the social links on your store, navigate to Store Design>Design Options and click the Carousel & Social Media tab. Scroll down to the Social Media section, and input the your various profile links into the corresponding fields beside Available Networks. Make sure to include  http:// before the link.

You can also re-order your social media links to display in a particular order by clicking on the dotted grid to the left of the icon and dragging it to rearrange the order. 

The links that are live on your storefront will, predictably, appear in the top  Live on Your Storefront section. 

How to set a favicon for your store

A favicon (also known as a  website icon, tab icon, or bookmark icon) is a small icon that represents your website and provides a shortcut to it wherever the icon appears. There are a whole bunch of sites that can help you generate a favicon for your store, or you can   create your own.

To upload a custom favicon for your store, first find or create an image   16 x 16px or 32 x 32px in dimension. The image must be saved in ICO, JPG, GIF, or PNG format.

Then go to Store  Design>Design Options, then click More>Favicon. Click Choose File to select the favicon from your computer. Click Upload Favicon.


Marketing is a huge topic, and we don't have the space to get too deep into it here. If you're looking for some basic articles to get your marketing juices flowing, BigCommerce has some   great resources, but for our part, we're going to focus on two things that most merchants want to get up and running before they launch their online store: banners and newsletters.

How to add a banner to your store

Banners allow you to add content to the top or bottom of categories or web pages without the need for code. They're great for advertising sales, displaying coupon codes and shipping information, and creating urgency around limited-time offers. A banner can only be applied to one page at a time. 

To create, edit, or delete existing banners go to  Marketing>Banners. 

Click the Create a Banner button in the top left side of your screen.

Enter a  Banner Name (which will only be used internally, and will not be visible to your customers). Then enter your Banner Content in the field below.

Select the page you want your banner to display on from the choices adjacent to  Show on Page. Note that you can only add a banner to one page at a time. 

Next, select the  Date Range for the banner to display. If your summer sale ends August 31st, for example, choose Only display this banner between specific dates, and make sure 31/Aug/2017 is selected as the end date.

Ensure you've checked the box  Visible before you save your banner if you're ready to have it live on your site.

And finally, use the  Location dropdown to select whether the banner should appear at the Top of [the] page, or Bottom of [the] page.

Save your work, then go to your store to see how your banner looks. You can customize the fonts and colors used in your banners from the  Banners tab of your theme editor (see instructions above).


Email Marketing is a great way to keep in touch and build relationships with your customers. BigCommerce comes with a built-in newsletter sign-up box and easily integrates with email marketing apps such as    MailChimpConstant Contact, and iContact. All customer data is stored on a CSV file, which can be accessed from Marketing › Email Marketing.

This is where you can select your email marketing service provider and customize the experience of visitors who add their email to your list. In Mogul, the newsletter signup appears right aligned in the footer of your store. Here:

By default, it also appears on the 'Order Confirmation' page at the end of the checkout process.

To configure your newsletter, start by selecting your provider from the  Email Integration Providers box at the top.

Then, check  Yes, allow customers to subscribe to the store newsletter from the Allow Newsletter Subscriptions? box. If you want to disable email collection at any time, you can uncheck this box and it will remove the field both from the footer of your store and the order confirmation page.

You can learn more about collecting newsletter subscriptions   here.

World-class customer support

We've covered a lot of ground in these docs, but there will no doubt be questions they don't answer. If you've got a burning question—or if you're just   stuck—don't hesitate to get in touch with us. Our friendly and knowledgable support team will dig into the issue and get you back on track ASAP.