Skip to content

Mention the Fediverse in the tag and post format suggestions - #4040

Open
pfefferle wants to merge 6 commits into
trunkfrom
add/pre-publish-tags-hint
Open

pfefferle wants to merge 6 commits into
trunkfrom
add/pre-publish-tags-hint

Conversation

@pfefferle

@pfefferle pfefferle commented Nov 9, 2026 •

Copy link
Copy Markdown
Member
Image

Proposed changes:

  • Hashtags help people on the Fediverse find a post, so I want to nudge users to add tags before they publish. WordPress.com already recommends tags, self-hosted sites only get the core suggestion, which says nothing about the Fediverse.
  • The core "Suggestion: Add Tag" text gets one more sentence: "Tags are also shared as hashtags, which help people on the Fediverse find your post." When "#hashtags in content" is enabled, it also says "Any #hashtag you write in your post is added as a tag too." This uses the i18n.gettext_default filter and matches the English source, so it works in every language and does nothing if core changes the string.
  • When the post format sets the type on the Fediverse, core's "Suggestion: Use a post format" text gets "The format also changes how your post is shared on the Fediverse."
  • The plugin's own format suggestion only shows when core's does not, using the same check as core. It looks like core's: "Suggestion: Use a post format", closed by default, with a link to apply the format. "Post format" confirms a format once it is set, and ⁂ is the panel icon instead of the default plugin icon.

Core only shows its tag suggestion when the site already has tags, so a site without any tags gets no hint. I think that is fine for now. I first opened the tag panel by itself, but that was hacky, so I filed WordPress/gutenberg#86688 and WordPress/gutenberg#86691 on Gutenberg and may come back to it in a follow-up.

/cc @allilevine @robertbpugh

Other information:

  • Have you written new tests for your changes, if applicable?

Testing instructions:

  • Use a site that has at least one tag and the default object type setting.
  • Create a new post with a short paragraph and no tags, click "Publish".
  • The "Suggestion: Add Tag" panel ends with the sentence about hashtags.
  • Enable "#hashtags in content", repeat, the second sentence shows up.
  • On a theme with post formats (Twenty Twenty-Five), add a single image block to a new post and click "Publish". Core's "Suggestion: Use a post format" ends with the sentence about the Fediverse.
  • On a theme without post formats, do the same. The plugin's "Suggestion: Use a post format" shows with the ⁂ icon.

Screenshots:

Changelog entry

  • Automatically create a changelog entry from the details below.
Changelog Entry Details

Significance

  • Patch
  • Minor
  • Major

Type

  • Added - for new features
  • Changed - for changes in existing functionality
  • Deprecated - for soon-to-be removed features
  • Removed - for now removed features
  • Fixed - for any bug fixes
  • Security - in case of vulnerabilities

Message

Before publishing a post without tags, the tag suggestion now explains that tags are shared as hashtags, which help people on the Fediverse find your post.

@pfefferle pfefferle added the Enhancement New feature or request label Nov 9, 2026
@pfefferle pfefferle self-assigned this Nov 9, 2026
@pfefferle
pfefferle requested a review from a team November 9, 2026 15:01
@github-actions github-actions Bot added the [Focus] Editor Changes to the ActivityPub experience in the block editor label Nov 9, 2026

@robertbpugh robertbpugh left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good overall, and the new sentence about tags being shared as hashtags reads well. I had Claude review it, and there's one title I think is worth changing, plus a small wording idea. Both are inline.

Comment thread src/pre-publish-panel/plugin.js Resolved
Comment thread src/pre-publish-panel/plugin.js Resolved

@robertbpugh robertbpugh left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the changes, the tag sentence reads well now. I had Claude look at the new version, and there's one thing in the description worth updating before merge, plus an idea for the format box. Both are inline.

Comment thread src/pre-publish-panel/plugin.js Resolved
Comment thread src/pre-publish-panel/plugin.js Resolved
@pfefferle pfefferle changed the title Open the tag suggestion before publishing and mention hashtags Mention the Fediverse in the tag and post format suggestions Nov 12, 2026

@robertbpugh robertbpugh left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for adding the format sentence, it reads well after core's text. I had Claude look at the latest version, and there are two small things worth a look before merge. Both are inline.

* @type {string}
*/
const CORE_TAGS_TEXT =
'%s help users and search engines navigate your site and find your content. Add a few keywords to describe your post.';

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On WordPress 6.5 to 6.8, which the plugin still supports, core's tag box says "Tags help users and search engines navigate your site..." with no %s. The %s version only came in after 6.8, so people on those versions never see the hashtag sentence. Could you match the old text too? It isn't passed through sprintf, so it wouldn't need the %% escaping.

Significance: minor
Type: added

Before publishing a post without tags, the tag suggestion now explains that tags are shared as hashtags, which help people on the Fediverse find your post.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The changelog only mentions the tag sentence, but people who update will also see the new format sentence and the reworded format suggestion. Maybe "Before publishing, the tag and post format suggestions now explain what tags and formats do on the Fediverse." so the entry covers both.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Enhancement New feature or request [Focus] Editor Changes to the ActivityPub experience in the block editor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants