Skip to content

TINYDOC-3494 - Add guidance for disabling or stripping HTML formatting#4286

Open
kemister85 wants to merge 3 commits into
tinymce/8from
hotfix/8/TINYDOC-3494
Open

TINYDOC-3494 - Add guidance for disabling or stripping HTML formatting#4286
kemister85 wants to merge 3 commits into
tinymce/8from
hotfix/8/TINYDOC-3494

Conversation

@kemister85

@kemister85 kemister85 commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Ticket: TINYDOC-3494

Site: Staging

Changes

Closes a documentation gap where users searching for how to disable or strip HTML formatting could not find direct guidance. The relevant configuration options (valid_elements, invalid_elements, extended_valid_elements, paste_as_text) already exist on the Content filtering page, but there was no worked guidance for restricting or stripping formatting, and no path to it from the Content formats page where these users typically land.

  • modules/ROOT/pages/content-filtering.adoc — Added a new "Disabling or stripping HTML formatting" section that:
    • Explains, at a behavioral level, that content is validated and cleaned against a schema when it is set, pasted, or retrieved, and that anything outside the schema is removed.
    • Describes what each option does (valid_elements replaces the allowed set, extended_valid_elements adds to it, invalid_elements removes named elements) and links each option mention to its section anchor on the page.
    • Provides three worked examples: restricting content to an allowed subset with valid_elements, removing specific formatting with invalid_elements, and stripping all formatting from pasted content with paste_as_text.
    • Cross-references the Schema and DomParser API reference pages and the Content formats page.
  • modules/ROOT/pages/content-formatting.adoc — Added a pointer from the Content formats page to the new guidance so users looking to restrict or strip formatting are directed to the correct page.

Validation

  • Option behavior verified against tinymce source (core/main/ts/api/html/Schema.ts, DomParser.ts).
  • Guidance describes option behavior only; no internal implementation functions are referenced.
  • Local Antora build passes; all cross-references resolve (option section anchors, apis/tinymce.html.schema, apis/tinymce.html.domparser, copy-and-paste#paste_as_text, content-filtering#disabling-or-stripping-html-formatting).

Prepared for documentation team review.

@kemister85
kemister85 marked this pull request as ready for review July 22, 2026 00:11
@kemister85
kemister85 requested review from a team and soritaheng as code owners July 22, 2026 00:11
@kemister85
kemister85 requested review from a team, MitchC1999, ShiridiGandham, shanmen-tiny and tiny-ben-tran and removed request for a team July 22, 2026 00:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant