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.
There is also a switch that allows you to enable/disable the Labels editor.
After making any changes in the Storefront Builder, be sure to apply them permanently using the Save Changes 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 includes a visibility icon (eye icon).
Click the icon to disable the section.
The preview updates immediately to show how the page will look without that section.
Click again to re-enable it.
This allows you to experiment with layout changes without permanently deleting elements.
5. Accessing detailed section settings
Some sections include an additional settings shortcut icon (the square-with-arrow icon visible in the sidebar).
This icon opens the corresponding configuration page in the X-Cart Admin area.
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.
6. Information Icon
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.
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!
Related articles





















