Skip to main content

Using the Storefront Builder (5.6.x)

A
Written by Anna Verbichenko
Updated over 2 weeks ago

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.

Customize storefront button

After clicking the button, you're redirected to the Storefront Builder page.

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.

Basic controls: settings toggle, viewport selector,

and display mode selector

There is also a switch that allows you to enable/disable the Labels editor.

Labels editor switch

After making any changes in the Storefront Builder, be sure to apply them permanently using the Save Changes button in the top-right corner.

Save Changes button

You can exit the Storefront Builder at any time using the Exit button in the top-left corner.

Exit button

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.

Labels editor switch

When the Labels editor is active, all text labels in the preview area appear highlighted, allowing you to identify and edit them directly.

Labels editor: Text labels are highlighted and can be edited

When you click on a text label in the preview area, a pop-up dialog appears, allowing you to edit the label text.

Text label editing dialog

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.

Left sidebar: Management of blocks/sections.

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).

Drag handle icon

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).

Visibility 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).

Settings shortcut icon

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).

Information icon

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.

Left sidebar: Management of theme settings

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.

Logo management

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.

Font management

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.

Color settings management

To enable manual color configuration, turn on the Use custom colors toggle.

Once enabled, you can configure your storefront color scheme.

"Use custom colors" option enabled

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.

Custom CSS management

To enable custom styling:

First, turn on the Use custom CSS toggle.

"Use custom CSS" = On

Then, enter your CSS rules in the editor field provided.

Custom CSS entered (example)

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!


Did this answer your question?