I have a custom css class that has been patched which I have verified in showconfig.aspx

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
      <setting name="WebStylesheet" value="/css/rte.css" />

I have verified the css via that url.

But in rich text editor I'm not seeing any classes under Apply Css Class. In both the content editor - rich text editor or the SXA rendering.

enter image description here

Is there a step I've missed doing? Using Sitecore 9.1 with SXA 1.8

My css is just:

.module-title {
  color: #373A40;
  text-align: center;
  margin-bottom: 1.5em;
  font-weight: 100;

Do I also have to update the ToolsFile.xml? I thought it would automatically pick up all the classes from the css file, and you only needed to use the xml to restrict what classes you wanted specifically to show.

  • 1
    Can you check the toolsfile.xml and see what is in the <classes> part? I think that should be empty if you want your styles to be picked from the css..
    – Gatogordo
    Commented Apr 9, 2019 at 12:26
  • 1
    @Gatogordo yay! that was the issue. There were some items in there mysteriously. Can you post as an answer so I can accept.
    – Jen
    Commented Apr 10, 2019 at 0:46

4 Answers 4


We encountered the same issue and fixed it in the ToolsFile.xml. Our experience is that the classes section of that file should be empty to have the classes from your attached css file to be imported in the dropdown of the RT editor.

This way there should be no need to add all your classes in the xml file and you can just use the external css file. Remember to clear (browser) caches when you make changes to it (the css file gets cached).

  • It seems like if you want the rich text editor to show the text with the classes applied. Then those classes need to be in the rte.css file. In which case you'd need to have a subset of classes in the ToolsFile.xml. It doesn't seem like the editor is loading the site css. (in case you can confirm from your experience)
    – Jen
    Commented Apr 11, 2019 at 4:43
  • 1
    That's right. The site css is nit loaded, just the RTE one from the setting.
    – Gatogordo
    Commented Apr 11, 2019 at 5:27

A method I much prefer for user-friendliness is to create a new paragraph type in the RTE Profile:

custom paragraph type

It looks like this in the Rich Text Editor window:

rich text editor window

This way you can choose the type of DOM element you want and can specify multiple classes.


It should pick up automatically, but you can try to add it to ToolsFile.xml

<class name="Your Class 1" value="your-class-1" />
<class name="Your Class 2" value="your-class-2" />
<class name="Your Class 3" value="your-class-3" />

toolsfile is located under <webroot>\sitecore\shell\Controls\Rich Text Editor\ folder.

Personally, I prefer creating snippets instead of adding a custom CSS class to a rich-text editor. It is a bit more user-friendly solution. You can add custom HTML snippets in the rich text editor profile, in the core database. e.g here /sitecore/system/Settings/Html Editor Profiles/Rich Text Full/Snippets

  • Thanks. We will be doing both, but some stuff makes sense to just be class driven.
    – Jen
    Commented Apr 10, 2019 at 0:40

You can use the ToolsFile.xml in conjunction with your CSS. However, the classes mentioned in the ToolsFile.xml must all match a class in the CSS file. This way, your display name can be different from your class name, which might be preferable for your users.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.