Design, Upgrades

How to Add Custom CSS

You can use the CSS editor to customize the appearance of any site with a Premium plan or higher. It works by allowing you to add your own CSS styles to override the default styles of your theme.

Table of Contents

Access the CSS Editor

To access the CSS editor, go to My Site → Appearance → Customize → Additional CSS:

The CSS editor

Note: you must have either Premium, Business ,or eCommerce active on your site to be able to add custom CSS to your site.

↑ Table of Contents ↑

Default Placeholder Comment

If you have never added CSS before or if you have recently changed themes, you will see the placeholder comment shown below.

/* Welcome to Custom CSS! To learn how this works, see */

The placeholder comment can be left in place or deleted and replaced with your custom CSS. It does not affect the code you add below.

↑ Table of Contents ↑

Previewing and Saving

When adding CSS code on your site, your changes will automatically be applied to the preview window, but they won’t actually be saved until you click the Save Changes button.

↑ Table of Contents ↑

CSS Revisions

The latest 25 revisions of your CSS edits are saved and can be accessed in the CSS editor.

CSS Revisions when your site does not have plugins installed

If your site does not have plugins installed, click CSS Revisions in the top right corner.

CSS Revisions when your site has plugins installed

If your site has plugins installed, click “See full history” at the bottom of the CSS editor. If the option does not show, it means there is no CSS history to restore.

↑ Table of Contents ↑

What if I change themes?

CSS is theme-specific, so all of your CSS is moved to a revision when you change themes. To review or restore past CSS, use CSS Revisions.

↑ Table of Contents ↑

CSS Help

Need CSS help? We can provide limited CSS support through live chat or email. Feel free to reach out and we’ll let you know if we can help with your CSS request. Otherwise, we can help point you in the right direction!

If you’re just getting started, there will be a learning curve, but CSS is a very valuable and reusable skill. There are a TON of great resources on the web to get you started with learning more about HTML and CSS. This handy series of articles on CSS is a solid starting point:

Here are a few tips:


↑ Table of Contents ↑

Advanced CSS controls

Media Width

This option should be used if you have modified the width of the primary content area using custom CSS. The “Content Width” setting is used as the default size for full-size images when they are inserted into your blog. Note that it will not affect the size of some images you added before changing the setting, depending on how they were inserted, and you may have to re-insert some of them after changing the setting.

Start Fresh

By default, the custom CSS you add to the CSS editor will be loaded after the theme’s original CSS which means that your rules can take precedence and override the theme’s styles.

You can turn the theme’s original CSS off completely by clicking the “Don’t use the theme’s original CSS” option in the Appearance → Customize → Additional CSS panel. This will allow you to use any theme as a blank canvas for designing with CSS. This is an advanced option and should only be used if you want to start over and design the CSS for your theme from scratch.

If you would like to build on top of the existing CSS rules—which is the most common and the recommended approach—then you can leave this option disabled.

If you are looking for where to find the theme’s original CSS to use it as a reference, the best thing to do is to use your browser tools. Most modern browsers have a web inspector built right in. You can right-click and select the “Inspect Element” option to see the HTML of the item you clicked on as well as all the CSS that applies to it. Two popular tools for viewing CSS are the Firefox Developer Tools and the Chrome Developer Tools. To help you get started, you can take a look at a support page with some brief screencasts on How to Find Your Theme’s CSS using the web developer tools included with browsers.

Preprocessor has support for CSS preprocessors LESS and Sass (SCSS Syntax). This is an advanced option for users who wish to take advantage of CSS extensions like variables and mixins. See the LESS and Sass websites for more information. You can select which syntax you would prefer to use at the bottom of the My Sites → Customize → Additional CSS panel.

Still confused?

Contact support.

Not quite what you're looking for?

Get Help