On this page
This article covers everything that shapes your public storefront: picking a theme, turning built-in pages on or off, building custom pages with shortcodes, customizing the menu and footer, filling in SEO fields, and white-labeling the site with your own branding. It is written for platform admins working in the /admin panel.
Where to find it
Most storefront controls live under Settings > General in the /admin sidebar, which opens a tabbed page:
- Branding - name, logos, colors, hero content, footer details, social links, and the navigation menu builder.
- Themes - pick the theme used on your main site (marketing pages, login, signup, cart).
- Theme Pages - enable or disable built-in storefront pages, and create custom pages plus custom CSS/JS.
There is also a Themes entry in the sidebar (at /admin/themes, shown if your account has theme management permission) that lists every theme installed on the platform, with previews and each theme's own pages and assets.
Each organization under your platform additionally has its own branding page, reachable from Organizations in the sidebar, for that organization's own logos, colors, and storefront text.
Choosing your theme
- Go to Settings > General and open the Themes tab.
- Pick a theme from the available list and apply it.
The theme you pick here applies to your main site only. Every organization under your platform picks its own theme separately in its own settings; an organization that has not picked one renders with the platform default theme, not with yours.
You can also create a custom theme from this tab: it is cloned from a base theme and stays private to your platform, so you can adjust it without affecting anyone else.
Turning built-in pages on and off
Every theme ships with the same set of built-in pages: Home, Events, Event Detail, Events Calendar, Contact, About, Cart, Checkout, Checkout Success, Checkout Cancel, Privacy Policy, and Terms & Conditions.
- Go to Settings > General > Theme Pages.
- Find the built-in page in the list.
- Use Disable or Enable on its row.
A disabled page disappears from the storefront menus automatically and returns a page-not-found error if someone visits its address directly. Two exceptions:
- Home, Cart, Checkout, Checkout Success, and Checkout Cancel are locked. They are essential to the storefront and have no toggle.
- Detail pages follow their listing. The Event Detail page cannot be toggled on its own; disabling the Events listing already hides every event's detail page.
Custom pages and shortcodes
- Go to Settings > General > Theme Pages and add a custom page.
- Give the page a title and a slug (the slug becomes its address).
- Pick a layout and a content type (Markdown or HTML), then write the content.
- Optionally fill in the SEO fields (see below) and save.
The page goes live at /page/your-slug (a short alias /p/your-slug works too). Link to it from your navigation menu or anywhere else.
Inside the content editor, the Insert Placeholder button drops in shortcodes that render live content when the page is viewed:
| Shortcode | What it renders |
|---|---|
[PRODUCT_LIST_CARD] |
Grid of products with search, filter, and pagination |
[COURSE_CATALOG] |
Course listing with categories, levels, and search |
[EVENT_LIST] |
Upcoming events with dates and registration |
[CONTACT_INFO] |
Your contact details (email, phone, address, hours) |
[EVENT_CARD id=1] |
One event card; replace 1 with the event's ID or slug |
[COURSE_CARD id=1] |
One course card; replace 1 with the course's ID or slug |
[PRODUCT_CARD id=1] |
One product card; replace 1 with the product's ID or slug |
[ORG_NAME] |
The site's display name |
[YEAR] |
The current calendar year |
The same tab also lets you add custom CSS and custom JS that load on your storefront, each of which can be activated or deactivated independently.
Navigation and footer
The storefront top menu is customizable from Settings > General > Branding, in the Navigation menu section:
- Add a menu item, then give it a label and a URL (a site path like /page/about-us, or a full external link).
- Optionally add drop-down items under it, each with its own label and URL.
- Reorder items and remove ones you no longer want.
Leave the list empty to keep the theme's built-in menu. Either way, links that point at a built-in page you have disabled are hidden automatically.
Footer content comes from the same Branding tab: a contact block (address, business hours, support email and phone, website URL), social media links, and an optional footer badge image such as an accreditation seal.
SEO fields
Custom pages, courses, and events all share the same SEO & Social section in their editors:
- Meta Title - the browser tab and search result title (aim for about 60 characters).
- Meta Description - the summary under the title in search results (aim for about 155 characters).
- Social Image - the image shown when the page is shared on social media.
- Canonical URL - leave blank to use the page's own address.
- Hide this page from search engines - adds a robots tag so search engines skip the page.
Everything is optional; blank fields fall back to sensible defaults.
Branding and white-label
The Branding tab white-labels every storefront under your platform: your name and display name, a logo for light and dark backgrounds, a favicon, logo height, and your color palette (Primary, Secondary, Accent, Button, Button hover, and Nav link hover). You can also set the home page hero block (background image, eyebrow text, headline, subtitle, and call-to-action button) and an illustration for the login and signup pages.
Organizations under your platform have their own white-label settings, so each one can present its own name, logos, and colors on its own site.
Why did this happen?
Why did a menu item disappear from the storefront?
The menu hides links to built-in pages that are disabled. Check Settings > General > Theme Pages and re-enable the page if you want it back. On an organization's storefront, the Events menu also hides itself whenever that organization has no upcoming public events of its own.
Why can't I disable the Home or Checkout pages?
Home, Cart, Checkout, Checkout Success, and Checkout Cancel are locked because the storefront cannot function without them. They never show a toggle and are always treated as active.
Why can't I toggle the Event Detail page on its own?
Detail pages fold into their listing page. Disabling Events already hides every individual event page, so a separate toggle would be meaningless.
Why didn't changing my theme change an organization's site?
Your theme choice applies to your main site only. Each organization owns its theme independently and there is no fallback to yours; an organization that never picked a theme uses the platform default. Change it in that organization's own settings.
Why does my shortcode show up as plain text?
The token must match exactly: uppercase letters inside square brackets, for example [EVENT_LIST], with attributes written like id=3 or id=my-event-slug (no quotes). Anything the renderer does not recognize is deliberately left as-is so your content is never mangled.
Why was my custom page slug rejected?
Slugs that belong to built-in pages (such as home, events, contact, checkout) are reserved. A custom page on one of those slugs would hijack the real storefront page and its enable/disable toggle, so the platform blocks it at save time. Pick a different slug.
Related
- Initial setup checklist
- Commerce: products, orders, and discounts
- Events and scheduling
- Branding and your storefront (for organization admins)
Still stuck? Contact your support team through support.