Skip to content

Add experimental Content Guidelines for site-wide editorial rules #75171

@aagam-shah

Description

@aagam-shah

What problem does this address?

As AI-powered content tools become more common in WordPress, site owners have no standardized way to define their editorial identity, content rules, and brand voice in a machine-readable format.

Today, if a site owner wants to maintain consistency across multiple content creators or AI tools, they must rely on external documents, tribal knowledge, or ad hoc solutions. There is no structured, in-WordPress system for:

  • Documenting brand voice, tone, and copy rules
  • Defining per-block content guidelines (e.g., heading structure, paragraph length, image alt text rules)
  • Providing a single source of truth that both humans and AI tools can reference
  • Importing/exporting editorial guidelines between sites

While theme.json defines how a site looks, there is no equivalent for how a site sounds and how content should be created. This gap becomes more significant as AI writing assistants integrate with WordPress and need to respect site-specific editorial standards.

What is your proposed solution?

Introduce Content Guidelines as an experimental feature in Gutenberg — a persistent, structured system for encoding editorial rules, brand voice, and content standards into WordPress.

The idea is to provide a settings-based UI where site owners can define guidelines across customizable categories (e.g., copy/tone, images, site context, block-specific rules). These guidelines would be stored as a custom post type with revision history, exposed via REST API, and extensible through PHP filters — allowing any plugin (SEO, AI, editorial workflow) to read and build on them.

Think of it as the content counterpart to Global Styles: where Global Styles standardize a site's visual identity, Content Guidelines standardize its editorial identity.

Key capabilities

  • Guideline categories: Copy, images, site context, block-specific rules, and a catch-all for custom needs
  • Block-specific rules: Per-block-type guidelines (e.g., rules for core/heading, core/paragraph, core/image)
  • Revision history: Built on CPT revisions for audit and rollback
  • Import/Export: JSON-based portability between sites
  • Experimental: Gated behind Gutenberg experiment flag, no impact when disabled

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    [Feature] GuidelinesAn experimental feature for adding site-wide editorial rules.[Status] In discussionUsed to indicate that an issue is in the process of being discussed[Type] FeatureNew feature to highlight in changelogs.[Type] Tracking IssueTactical breakdown of efforts across the codebase and/or tied to Overview issues.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions