How Do I Customize the Styles Drop-Down List?

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

You need to pass your own style definitions to the CKEDITOR.stylesSet.add function, giving them a unique name, and then configure the editor to use them by setting the stylesSet value.

CKEDITOR.stylesSet.add( 'my_styles',
[
	// Block-level styles
	{ name : 'Blue Title', element : 'h2', styles : { 'color' : 'Blue' } },
	{ name : 'Red Title' , element : 'h3', styles : { 'color' : 'Red' } },

	// Inline styles
	{ name : 'CSS Style', element : 'span', attributes : { 'class' : 'my_style' } },
	{ name : 'Marker: Yellow', element : 'span', styles : { 'background-color' : 'Yellow' } }
]);

Depending on whether your definitions were placed inline or in an external file, you need to set the stylesSet configuration setting accordingly.

// For inline style definition
config.stylesSet = 'my_styles';

// For a definition in an external file
config.stylesSet = 'my_styles:http://www.example.com/styles.js';

For more details on the definition format and best practices on how to customize the styles please refer to the Styles article from the Developer's Guide.

Stylesheet Parser Plugin

Note that since CKEditor 3.6 you can also populate the Styles drop-down list with style definitions added in an external CSS stylesheet file. The optional Stylesheet Parser plugin (stylesheetparser) lets you use your existing CSS styles without the need to define the styles specifically for CKEditor in the format presented above.

For more information on using the plugin refer to the Stylesheet Parser Plugin section of the Developer's Guide and check the "Stylesheet Parser plugin" (stylesheetparser.html) sample from the _samples folder of your CKEditor installation package.