[[structure-text-format-config]]

=== Configuring Text Formats and Editors

[role="summary"]
How to make a change to a text format and its editor configuration.

(((Text format,configuring)))
(((Configuring,text format)))
(((Editor,configuring)))
(((Ckeditor text editor,default assignment to text format)))
(((WYSIWYG (What You See Is What You Get),configuring editor)))
(((What You See Is What You Get (WYSIWYG),configuring editor)))
(((Module,Filter)))
(((Module,Editor)))
(((Module,CKEditor)))
(((Filter module,configuring)))
(((Editor module,configuring)))
(((CKEditor module,configuring)))

==== Goal

Add a horizontal rule tag to the _Basic HTML_ text format, and a corresponding
button to its editor configuration.

==== Prerequisite knowledge

<<structure-text-formats>>

==== Site prerequisites

* The core Filter, Editor, and CKEditor modules must be installed. They are
installed on your site when you install with the core Standard installation
profile.

* The _Basic HTML_ text format must exist. This is created on your site when you
install with the core Standard installation profile.

==== Steps

. In the _Manage_ administrative menu, navigate to _Configuration_ > _Content
authoring_ > _Text formats and editors_ (_admin/config/content/formats_). The
_Text formats and editors_ page appears.

. Click _Configure_ for the _Basic HTML_ text format. The _Basic HTML_ page
appears.

. Note that _Ckeditor_ is selected in the _Text editor_ field. This allows you
to configure the editor's toolbar.

. Drag the _horizontal rule_ button from _Available buttons_ to _Tools_ in
_Active toolbar_. You may need to click the _Show group names_ link to see the
_Tools_ group name.
+
--
// Button configuration area on text format edit page.
image:images/structure-text-format-config-editor-config.png["Configuring the editor",width="100%"]
--

. Note that you can change the _Filter processing order_.

. In the field _Allowed HTML tags_, add `<hr>` to what is already present.
+
--
// Allowed HTML tags area on text format edit page.
image:images/structure-text-format-config-allowed-html.png["Configuring the HTML tags",width="100%"]
--

. Click _Save configuration_. You will be taken back to the _Text formats and
editors_ page. A message will be displayed saying that the text format has been
updated.
+
--
// Confirmation message after updating text format.
image:images/structure-text-format-config-summary.png["Confirmation message for text format configuration"]
--

==== Expand your understanding

If you do not see the effect of these changes in your site, you might need
to clear the cache. See <<prevent-cache-clear>>.


// ==== Related concepts

// ==== Additional resources


*Attributions*

Written by https://www.drupal.org/u/batigolix[Boris Doesborg].
