Elements of marketing banners at pageʼs top and/or bottom.
global{{banners}} object
Handlebars Expressions
{{banners}},
{{{banners}}}
Handlebars Formatting Exception
Where a banner contains HTML, the banner helper must be placed in triple braces, as in this example {{{banners}}}.
(Double braces would escape the HTML.)
Limits
{{banners}} will only return the first 50 banners on each page.
bottomarray[string]
Array of HTML content/strings, for custom bottom-banner content; banners are populated from the BigCommerce control panel
toparray[string]
Array of HTML content/strings, for custom top-banner content; banners are populated from the BigCommerce control panel
blog
brand
brand_results
{{brand_results}} array
urlstring
Example: https://www.example/test-brand/
namestring
Example: Test brand
brands
breadcrumbs
Defines a pageʼs breadcrumbs. Available on virtually all pages that have a breadcrumb trail.
global{{breadcrumbs}} array
Handlebars Expression{{breadcrumbs}}
namestring
Displayed name of this breadcrumb element.
urlstring
URL of this breadcrumb element.
carousel
A list of images, text, and style assets for a storefront’s image slide show.
{{carousel}} array
Handlebars Expression{{carousel}}
slidesarray[object]
Object containing properties for each slide in the slideshow.
swap_frequencyinteger
Indicates how often (in seconds) the slides will change; the value must be between 1 and 90,000 seconds.
cart
The cart-specific properties for the current session.
{{cart}} object available to templates/pages/cart.html; contains cart_id if one exists.
Handlebars Expression: {{cart}}
additional_checkout_buttonsarray[string]
Generates checkout buttons for third-party payments (PayPal, Google Checkout, etc.)
couponsarray[object]
List of coupons applied to the cart; default sorting is by coupon ID, from lowest to highest.
discountobject
Discount being applied to the cart in the current session.
gift_certificatesarray[object]
List of gift certificates applied to the cart.
gift_wrapping_costobject
Price object that defines the cost associated with adding gift wrapping to the items in the cart.
grand_totalobject
Price object that defines the total cost of all the items in the cart. Incorporates estimated shipping, discounts, taxes, and gift wrapping.
itemsarray[object]
quantityinteger
shipping_handlingobject
Current configuration of the shipping estimator for this session’s current cart; will be null/undefined if the cart contains no physical products.
show_multiple_address_shippingboolean
Boolean: If > 1 physical items are in the cart, and checkout button is displayed: whether to also display the "Ship to multiple addresses" / "Multiple Shipping Addresses" user option.
show_primary_checkout_buttonboolean
Boolean that determines whether to show a checkout button.
status_messagesarray[object]
sub_totalobject
Price object that defines the total cost of all the items in the cart. Might or might not include tax, based on the tax display settings the merchant has configured. Excludes shipping, discounts, and gift wrapping.
taxesarray[object]
List of all applicable taxes for the cart.
cart_id
Returns the cart ID if one exists. To return more cart information use the Storefront Cart API.
global{{cart_id}}
Handlebars Expression: {{cart_id}}
categories
category
category_results
{{category_results}} array
urlstring
Example: https://www.example/card-testing/
namestring
Example: Card Testing
checkout
Used to access checkout content and data in templates\pages\order-confirmation.html.
The {{checkout}} object is available to checkout and order confirmation templates and components.
The {{countries}} array available to templates/pages/account/payment-methods.html; used in country and state dropdowns when submitting add payment form.
Handlebars Expression: {{countries}}
currencyarray[object]
Details about the currency associated with the country.
Object to enable the current customer to create a store account. (Called on the default <theme-name>/templates/pages/auth/create-account.html template.)
Handlebars Expression: {{forms.create_account}}
continue_urlstring
currency_selector
A list of all supported currencies, and the currency that is actively in use in the storefront.
global{{currency_selector}}
Handlebars Expression: {{currency_selector}}
active_currency_idstring
ID of the currency actively in use in the storefront.
active_currency_flagstring
Country flag used to represent the active currency.
active_currency_namestring
Name of the active currency.
active_currency_codestring
Code for the active currency.
currenciesarray[object]
List of all the currencies supported for this storefront.
customer
customer_group_id
global{{customer_group_id}}
customer_group_name
global{{customer_group_name}}
downloads
Property for digital (non-physical) products. Exposed on the default <theme-name>/templates/pages/account/download-item.html template.
Example: "<p>We're happy to answer questions or help you with returns.<br />Please fill out the form below if you need assistance.</p>"
head
global{{head}} object containing data configured for the HTML <head> element.
Handlebars Expression: {{head}}
faviconstring
The storeʼs favicon.
meta_tagsstring
Meta tags to improve store SEO.
scriptsstring
Scripts to be loaded in the <head> tag.
stylesheetsstring
CSS files to be included.
titlestring
Current pageʼs title.
is_ajax
global{{is_ajax}} boolean; returns true if the current request is an AJAX request
Handlebars Expression: {{is_ajax}}
No properties available for this object.
order
page
{{page}} object present on content pages, forms, and RSS feeds.
Handlebars Expression: {{page}}
breadcrumbsarray[]
Present if page has ancestors.
contentstring
HTML content of the page
feedarray[object]
Present if page is an RSS feed page.
idinteger
sub_pagesarray[object]
Array of child pages
titlestring
Title of this child page
page_type
A string representing the type of page currently displayed.
global{{page_type}} string.
Handlebars Expression: {{page_type}}
All possible values for {{page-type}} are:
account_orderstatus
account_order
account_addressbook
shippingaddressform
account_new_return
add-wishlist
account_recentitems
account_downloaditem
editaccount
account_inbox
account_saved_return
account_returns
account_paymentmethods
account_addpaymentmethod
account_editpaymentmethod
login
createaccount_thanks
createaccount
getnewpassword
forgotpassword
blog
blog_post
brand
brands
cart
checkout
category*
compare
page_contact_form
error
404
giftcertificates
giftcertificates_balance
giftcertificates_redeem
default*
orderconfirmation
page*
product*
amp_product_options
search
rss
sitemap
newsletter_subscribe
wishlist
wishlists
The four most-commonly-used values for {{page_type}} are marked with asterisks.
pages
global{{pages}} object containing storefront content page data
Handlebars Expression: {{pages}}
URLstring
URL of the page.
childrenarray[object]
List of child pages for this page.
namestring
Name of the page.
pagination
{{pagination}} object available to templates containing paginated lists, such as templates/pages/category.html and templates/pages/brands.html.
Handlebars Expression: {{pagination}}
anyOf:
BrandBlog
categoryobject
price
product
product_results
{{product_results}}
productsarray[object]
ratinginteger
num_reviewsinteger
priceobject
tax_labelstring
Example: Tax
categoryarray[object]
products
remote_api_scripts
Empty array. No properties are available for this object.
Handlebars Expression: {{remote_api_scripts}}
settings
shipments
{{shipments}} array available to templates/pages/account/orders/details.html
date_shippedstring
shipping date for this shipment
shipping_methodstring
shipping method for this shipment
shipping_providerstring
shipping carrier for this shipment
shipping_trackobject
tracking information for this shipment
show_shipping_methodboolean
boolean indicating whether shipping method should be displayed to customer or not
shipping_messages
{{shipping_messages}} object available to templates/pages/home.html
shop_by_brand
Objects to enable customers to shop by brand. Returns top 10 brands, by product count. (Called on the default templates/components/brand/sidebar.html and templates/components/common/footer.html partials.)
global{{shop_by_brand}} array of top 10 brands by product count.
Handlebars Expression: {{shop_by_brand}}
countstring
Number of products matching this brand.
idstring
ID for this brand.
namestring
Name of this brand.
urlstring
URL for this brand.
sitemap
A list of all sitemap properties for this BigCommerce storefront: pages, categories, and brands.
{{sitemap}} object available to templates/pages/sitemap.html.
Handlebars Expression: {{sitemap}}
bodyarray[object]
List of all sitemap subsections
labelstring
Subsection title (pages, categories, brands).
show_all_linkboolean
subsection_urlstring
URL to subsection content (pages, categories, brands) of the sitemap.
titlestring
social_media
global{{social_media}} array of all social-media site links for the storefront.
Handlebars Expression: {{social_media}}
namestring
Internal name of this social-media platform. For example, instagram.