Theme User Guide

This user guide is work in progress. Please feel free to contact us with any usage questions and we'll be happy to talk you through it.

Contents

  • Special Custom fields
  • Theme Settings > Global
  • Theme Settings > Header & Footer
  • Theme Settings > Homepage
  • Theme Settings > Product
  • Widget: Custom Blocks
  • Widget: Custom Banner
  • Simple HTML/CSS Examples

Special Custom fields

Custom Field Name
hidden
Custom Field Value
warranty

Displays any text/html you've entered into the warranty info box [ Products > Edit > Other Details ] on product cards. When this field is added, a small button will appear at the bottom of the corresponding product card. When the button is clicked, a small popup will appear over the card, showing the warranty content. The label/name for this button can be changed via [ Admin > Storefront > Themes > Customize > Theme Styles > Products > Warranty tab label ]

Custom Field Name
hidden
Custom Field Value
spotlight

Turns a product into a spotlight product on product cards. The product will take the full width of the row, have a border around it and a photo carousel. Ideal for when you want to make a product stand out on category pages.

Custom Field Name
hidden
Custom Field Value
payment

Changes the product detail page into a payment page. Also prevents the product from appearing in category and search results. Ideal for sending to a customer as a payment link requesting a specific amount be paid.

Custom Field Name
hidden
Custom Field Value
show-quantity

Shows the quantity on product detail page when global quantity display is turned off. [ Admin > Settings > General > Display > Show Quantity Box for Products > Unticked ]

Custom Field Name
hidden
Custom Field Value
hide-quantity

Hides the quantity on product detail page when global quantity display is turned on. [ Admin > Settings > General > Display > Show Quantity Box for Products > Ticked ]

Custom Field Name
hidden
Custom Field Value
search

Stops the product from appearing in quick search and search results.

Custom Field Name
_breadcrumb
Custom Field Value
Comma separated category names.
Example: Clothing,Womens,Dresses

Creates a custom breadcrumb trail on the product detail page (Replaces the default breadcrumb trail). Example: Clothing > Womens > Dresses

Custom Field Name
_download
Custom Field Value
Exact file name including extention.
Example: my-file.pdf

Adds a download button below the product description. The file must be uploaded into your server "content" folder using WebDAV. For more information on how to do this please read this BigCommerce article or call/email if you need help.

Custom Field Name
_upsell
Custom Field Value
Comma separated Product ID's.
Example: 23,178,98

Creates an upsell area showing other products under the main add to cart.

Custom Field Name
_badge
Custom Field Value
Custom text.
Example: New

Adds a custom label/badge to the product listings and main product gallery image using whatever text has been added in the value field (keep it short).

You also add a custom background colour to the badge by adding a colour hex code after the field name (e.g. "_badge#00ff00") and add a custom text colour after the field value (e.g. "End of Line#003300").

Custom Field Name
_class
Custom Field Value
Custom text.
Example: my-class

This will add a CSS class (using whatever text has been added in the value field) to product cards and the product detail page.

Custom Field Name
_imageset
Custom Field Value
Name of the Product Option to be used as a trigger
Example: Colour

When the specified option is selected (E.g. Colour) the theme will show a specific set of images depending on the selected product option. For example: if the user selects "Blue" it will only show the designated blue pictures. For this to work it also requires the option values to be added to the end of each product image's alt text as imageset:value (e.g. imageset:Blue).


Theme Settings > Global

Content pending...


Theme Settings > Header & Footer

Content pending...


Theme Settings > Homepage

Content pending...


Theme Settings > Product

Content pending...


Widget > Custom Blocks

Content pending...


Widget > Custom Banner

Content pending...


Simple HTML/CSS Examples

Content pending...

We'd love to build a BigCommerce site with you.

Get in touch now Use the quick form on the right to get in touch now →