Custom CSS is a tool of the Theme Tweaker addon that aims at changing the design elements of the skin and adding a custom CSS code to the existing X-Cart pages so that a modified code is aggregated with the other software files automatically. Using Custom CSS you can change the skin colors, fonts, background, etc.

Adding Custom CSS Code to the Site

All changes that are applied through the Custom CSS tool facilities are applied storewide (i.e. to a store as a whole, but not to a single page of a store) and are recorded in the Look and Feel > Custom CSS & JS section of your store Admin area.

Adding Custom CSS Code in the Admin Area

To add Custom CSS code:

  1. Open the Custom CSS section of the Admin area (Look & Feel -> Custom CSS & JS) custom_css.png
  2. Turn on the Use custom css toggle.
  3. Clean the text area beneath the toggle and add your custom CSS code there. code_deleted_1.png
  4. Save the changes.

Adding Custom CSS Code in the Storefront

If you need to see the changes while you are adding them, use the Custom CSS tool in the storefront.

You should be logged in as a store administrator to see the tools bar.

For this purpose:

  1. Open the Custom CSS tool on any page of your site storefront and turn ON the Use Custom CSS option. 541-custom-css-on.png

  2. Enter your custom CSS code to the text area.
  3. Save the changes.

Let’s check how the skin changes are applied based on the demo css code provided.

The figures below show one and the same page with a custom css code applied and without it.

Default page layout541-custom-css-default-background.png
Customized page layout541-custom-css-blue-background.png

As you see the custom css code changes the background of the “Categories” block.

The blue background and the font color is set by the following piece of code:

 * Specific styles for the Top categories block in the side bar
.sidebar .block.block-top-categories .head-h2 {
  background: #f7fcff;

.sidebar div.block.block-top-categories div.content {
  background: #f7fcff;

.sidebar div.block.block-top-categories div.content a {
  color: #6f9cd9;

If we change #f7fcff to #F5F5DC the background will look as follows:


You can use the demo css code to learn how to apply similar changes to your store skin.

Adding JS Code to the Site

It’s also possible to add javascrips to your site.

For this purpose:

  1. Open Custom JavaScript section of the Admin area (Look and feel -> Custom CSS & JS). custom_JS.png
  2. Turn the Use custom js toggle on
  3. Paste your custom JS code to the text area.
  4. Save the changes.

Javascripts are stored in one file and both custom CSS and JS are added to the <HEAD> tag after all style files applied.