Loading...

Text Formats and Editors

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:

FiltersDescription
HTML filters
  • Limit allowed HTML tags: Specify which HTML elements and attributes are permitted
  • HTML corrector: Fix broken HTML markup
  • Display any HTML as plain text: Escape all HTML tags
Link filters
  • Convert URLs into links: Automatically link recognized URLs
  • Convert line breaks into HTML: Convert newlines to <br> or <p> tags
  • Pathologic: Fix links in content when moved between environments
Media and Embed filters
  • Display embedded entities: Show referenced entities inline
  • Align images: Control image alignment with classes or styles
  • Embed media: Allow media embeds from external sources
Special content filters
  • Caption filter: Support image captions
  • Token filter: Replace tokens with dynamic values

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.

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Back to Section navigation