Overview
X-Cart's Storefront Builder allows you to visually manage your storefront layout and theme settings using a live preview interface.
You can access the Storefront Builder using the Customize storefront button on the Design > Themes page.
After clicking the button, you're redirected to the Storefront Builder page.
The screen is divided into two main areas:
Left sidebar – contains layout or theme controls.
Preview area – displays the storefront and reflects changes in real time.
The Builder provides several basic controls that allow you to:
switch between Layout settings and Theme settings in the sidebar:
switch between desktop, mobile and full screen view modes in the preview area:
toggle between Dark/Light modes for the preview area:
enable/disable the Labels editor:
Undo/Redo the latest changes:
After making any changes in the Storefront Builder, be sure to apply them permanently using the Save button in the top-right corner.
You can exit the Storefront Builder at any time using the Exit button in the top-left corner.
The following sections provide information about the Labels editor, Layout settings and Theme settings.
Labels editor
Most text elements in the storefront are stored as text labels. You can easily edit them using the Labels editor, which is available as part of the Storefront Builder. To activate the editor, use the switch located at the top of the screen.
When the Labels editor is active, all text labels in the preview area appear highlighted, allowing you to identify and edit them directly.
When you click on a text label in the preview area, a pop-up dialog appears, allowing you to edit the label text.
The dialog displays the current label value and provides a text field where you can modify it. After making changes, click Save changes to apply them or Cancel to discard your edits.
Layout settings mode
When the toggle at the top of the left sidebar is set to Layout settings, the sidebar displays the list of sections and blocks that make up the currently opened page.
1. Navigating pages in the Preview area
The Preview area behaves like a live version of your storefront:
You can click buttons, follow links, and navigate between pages just as a customer would.
The left sidebar automatically updates to reflect the structure of the page currently opened in the preview.
For example, if you navigate from the Front page to a category or product page, the sidebar will update to display the sections and blocks that belong to that page.
2. Identifying sections and blocks
When you move the cursor over items in the left sidebar, the corresponding section/block is highlighted with a blue outline in the preview area. This helps you visually identify which part of the page you are editing.
3. Reordering sections and blocks
Each section/block has a drag handle icon (four-directional arrow).
You can:
Click and drag a section/block to reposition it.
See the updated layout immediately in the preview area.
Changes are reflected instantly, allowing you to fine-tune page structure visually.
4. Enabling and disabling sections
Each section's visibility status is controlled by a visibility icon (eye icon).
Click the icon to disable/re-enable the section.
The preview updates immediately to show how the page will look with the section hidden/visible.
This allows you to disable sections and blocks without permanently deleting items.
The names of hidden sections and blocks are grayed out. Hidden items are displayed as a separate list.
The Hidden items counter ((1) in the screenshot) allows you to see the number of currently hidden sections and blocks within the page layout.
The list of hidden items can be hidden and revealed using the Hide/Show links.
Clicking Hide allows you to see only visible items:
Clicking Show allows you to see the list of hidden items again:
5. Accessing detailed section settings
The available controls depend on the type of section.
For sections whose configuration is managed outside of Storefront Builder (for example, Primary menu or Featured products), a shortcut icon (square-with-arrow) is displayed. Clicking this icon opens the corresponding page in the X-Cart Admin area, where you can access the section's detailed settings.
Examples:
Primary menu / Footer menu
Clicking the shortcut icon opens the menus & pages management page (Design → Menus & Pages) where you can edit menu structure and content.
Featured products
This section is one of X-Cart's standard promotional blocks; it is powered by the Featured Products add-on. Clicking the shortcut icon opens the management section for Featured Products.
For sections that are configured directly within Storefront Builder (such as Announcement Bar and any sections added via Add section), management options are available from the three-dot menu. Click the menu to access the available actions and settings for the selected section.
6. Viewing additional information
Some sections in the left sidebar may include an information icon (an "i" in a circle).
This icon provides additional details about how the respective section works.
One example is the Sale section, which is powered by the Sale add-on.
7. Adding and managing sections
The Storefront Builder allows you to add new content blocks (sections) to your page layout using the Add section button in the Central column.
Each section type (e.g., Banner, Slideshow, Gallery) comes with its own set of settings and can be customized individually.
For a step-by-step guide on adding sections, configuring their settings, and managing them, see Adding and managing sections in the Storefront Builder (5.6.x).
Theme settings mode
When you switch from Layout settings to Theme settings, the left sidebar displays theme-related configuration settings instead of page structure.
The settings allow you to control:
Logo
Fonts
Colors
Custom CSS
These settings affect the overall appearance of the active design theme.
Changes made here are also reflected in the preview area in real time.
1. Managing the logo
The Logo section allows you to configure the store logo separately for desktop and mobile views.
You can upload and manage:
Desktop logo
Mobile logo
Each version can be configured independently to ensure optimal display across devices.
For both desktop and mobile logos, you can:
Upload or replace the logo image.
Specify the ALT text for accessibility and SEO purposes.
Changes are immediately reflected in the preview area, allowing you to verify how the logo appears in both desktop and mobile modes.
2. Configuring fonts
The Fonts section allows you to control the primary font family used across your storefront.
You can select a font family from the available dropdown list (for example, "Open Sans", Helvetica, Verdana, sans-serif).
The selected font family is applied globally to your storefront theme and is instantly reflected in the preview area.
3. Managing color settings
The Colors section allows you to customize the main color scheme of your storefront.
To enable manual color configuration, turn on the Use custom colors toggle.
Once enabled, you can configure your storefront color scheme.
Color changes are applied immediately in the preview area, allowing you to fine-tune the visual appearance of your store in real time.
4. Using custom CSS
The Custom CSS section allows you to add your own CSS rules to modify the appearance of your entire online store.
To enable custom styling:
First, turn on the Use custom CSS toggle.
Then, enter your CSS rules in the editor field provided.
Custom styles are applied globally and override default theme styling where applicable.
This option is intended for advanced customization and may require knowledge of CSS.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!































