Regions
Regions are named locations in a Stencil theme’s template files that make a page editable in a visual editor. By declaring regions, you give store users defined places to add, arrange, and configure content through either of BigCommerce’s two visual editors — Page Builder or Makeswift — without editing theme files or writing code.
Makeswift on Stencil is currently in Beta. Features and availability are subject to change.
Declaring a Region
You add a region within a template file using the region Handlebars helper. Name the region however you like, but it is best practice to give it a name that describes its location and function:
A template file can have as many regions as you want. A single region can hold more than one widget, and the sort_order on each widget placement controls how the widgets stack within the region on the storefront. Wherever you place a region, the corresponding drop target appears in the visual editor — and it works the same way in both Page Builder and Makeswift.
Regions can only be added to files under templates/pages, including its subfolders.
Global Regions
Global regions are special regions you can use to place and manage content sitewide. A widget placed in a global region appears on every storefront page where that region exists, which makes global regions useful for high-priority content such as promotional banners across multiple pages.
To create a global region, add the --global suffix to the region name:
To remove a default global region from your theme, delete or comment out its {{{region name="..."}}} line — for example, the header_bottom--global region in templates/components/common/header.html.
Like standard regions, global regions behave identically in both Page Builder and Makeswift.