Text formats define how user-entered content is processed, filtered, and displayed in Formatted text fields. Text formats combine with text editors to control the editing experience for Formatted text fields and ensure that the content meets security and presentation standards.

Text formats¶

A text format is a set of processing rules that:

• Define what HTML elements are allowed.
• Specify which text filters are applied.
• Control how links, media, and other elements behave.
• Enforce security by removing potentially dangerous markup.
• Format text according to defined standards.

Text formats are paired with editors such as CKEditor to provide the content creation interface for formatted text fields. For more information about text formats, visit Text formats.

Default text formats¶

Acquia Source includes a pre-configured text format with rich text editing and without rich text editing, which can be customized based on requirements. For information about how to manage text formats, visit Managing text formats.

Filters¶

Text formats use filters to process input. Filters control what you can add to the content of your website, and how that content is displayed. By carefully configuring filters, you can create a secure, consistent, and well-moderated website. 

Filters help promote:

• Security
• Accessibility
• Display consistency

The following table lists the types of filters in Acquia Source:

CKEditor configuration¶

When using CKEditor with a text format, you can configure:

• Toolbar: Drag buttons into/out of the active toolbar to enable or disable them.
• Available plugins: Enable or disable specific CKEditor features.
• Editor appearance: Set height, width, and other display options.

• Plugin settings: Configure options for enabled plugins.

  The following are common CKEditor plugins:

  • Format buttons such as Bold and Italic.
  • Heading styles
  • Lists
  • Link creation
  • Media embedding
  • Tables
  • Source code view

Format switching¶

Format switching enables users to switch between formats when editing. User with permissions to use multiple formats can view and use the format selector in the editor.

For a user to switch between text formats :

• The user has permissions to use multiple formats.

  This requires assigning text formats to specific roles. For more information, visit Managing text formats. 

• The field must be configured to allow multiple text formats.

  For more information, visit Using text formats with fields.