---
title: Personalizing the editor toolbars and buttons
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

The [editor](https://docs.kentico.com/k8/managing-website-content/configuring-the-environment-for-content-editors/configuring-the-editor.md) toolbar is flexible and customizable. By default, the system uses different toolbar configurations for different types of content. This helps keep the interface clean. You can also modify the default toolbar sets or prepare your own custom sets.

> **Info:** **Standard toolbar sets**
>
> Kentico ships with several standard toolbar sets that are used by various applications:
>
> - **Full/Default** - used for structured documents.
> - **Wireframe** - used when editing certain wireframe components.
> - **Basic** - the simplest toolbar set.
> - **ProjectManagement** - used for project management.
> - **BizForm** - used for Form application forms.
> - **Forum** - used for the editor in forums (if enabled).
> - **Newsletter** - used for newsletters.
> - **Reporting** - used for reporting.
> - **SimpleEdit** - used for simple editing.
> - **Invoice** - used for invoicing.
> - **Group** - used for groups.
> - **Widgets** - used for widgets.

## Defining toolbar sets

You can either modify existing toolbar sets or create your own custom toolbar sets.

To define toolbar sets, edit the **\<web project>\CMS\CMSAdminControls\CKeditor\config.js** file.

The following code sample shows a definition of the default toolbar set containing all available buttons. You can create custom toolbar sets by using names of the default buttons, or by adding buttons of [custom CKEditor plugins](https://docs.kentico.com/k8/managing-website-content/configuring-the-environment-for-content-editors/configuring-the-editor/installing-ckeditor-plugins.md).

```javascript title="Default toolbar set definition"

config.toolbar_Full = config.toolbar_Default =
[
    ['Source', '-'],
    ['Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord', 'SpellChecker', 'Scayt', '-'],
    ['Undo', 'Redo', 'Find', 'Replace', 'RemoveFormat', '-'],
    ['Bold', 'Italic', 'Underline', 'Strike', 'Subscript', 'Superscript', '-'],
    ['NumberedList', 'BulletedList', 'Outdent', 'Indent', 'Blockquote', 'CreateDiv', '-'],
    ['JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock', '-'],
    ['InsertLink', 'Unlink', 'Anchor', '-'],
    ['InsertImageOrMedia', 'QuicklyInsertImage', 'Table', 'HorizontalRule', 'SpecialChar', '-'],
    ['InsertForms', 'InsertPolls', 'InsertRating', 'InsertYouTubeVideo', 'InsertWidget', '-'],
    ['Styles', 'Format', 'Font', 'FontSize'],
    ['TextColor', 'BGColor', '-'],
    ['InsertMacro', '-'],
    ['Maximize', 'ShowBlocks']
];

```

![The editor toolbar](https://docs.kentico.com/docsassets/k8/personalizing-the-editor-toolbars-and-buttons/the_editor_toolbar.png)

Each toolbar set definition consists of several arrays representing toolbar groups. For example, the \['Styles', 'Format', 'Font', 'FontSize'] array represents a group of four buttons.

If you need to insert a line break between the button groups, use the _'/'_ string.

If you want to define your own toolbar set, add a command in the  _**config.toolbar\_ToolbarName**_  format to the **config.js** file.

> **Note:** **Important**: When you modify the _config.js_ file (or any other file used by the editor), the changes only apply after you _**clear your browser cache**_.

After defining a custom toolbar, you need to configure page or document types to use your new toolbar set.

## Assigning the toolbar set to a page

To assign the toolbar set to a page with editable regions (edited on the **Page** tab), you need to configure web parts of the _Editable region_ type on the page template. Specifically, you need to set their **HTML editor toolbar set** property values to the name of your toolbar set.

![Changing a toolbar set in a web part](https://docs.kentico.com/docsassets/k8/personalizing-the-editor-toolbars-and-buttons/changing_toolbar_set.png "Changing a toolbar set in a web part") 

## Toolbar set used for structured documents

If you want to modify a toolbar set used for **structured documents** (edited on the **Form** tab), you need to set the **Toolbar set** property value of the custom field. If you share the toolbar between multiple fields, the first field toolbar set will be used.

## Configuring visibility of editor buttons

With Kentico, you can show or hide buttons from the integrated editor toolbar. Each button in the toolbar is represented by a UI element.

1. Open the **UI personalization** application.
2. On the **Editor** tab, select a **site** and a **role**.
3. Browse the UI element tree and select or clear the check boxes that represent the editor buttons.

The system automatically saves the settings as you select or clear check boxes in the UI element tree. The system hides the buttons (UI elements) that have their check box cleared from users in the selected role.

> **Info:** If a user is a member of multiple roles, they're allowed to see UI elements from all their roles combined.

### Toolbar personalization on the live site

Toolbar personalization is disabled by default on the live site. If you wish to apply UI personalization to editor toolbars on the live site, add the following key to the **/configuration/appSettings** section of your project's web.config file:

```html

 <add key="CKEditor:PersonalizeToolbarOnLiveSite" value="true" />

```

Once this is done, all UI personalization settings apply to editors on the live site.