The AI Tag Suggestion feature scans your post content and surfaces matching tags from your publisher’s existing tag library — directly inside the Tags field, without leaving the editor.
Entry point
The AI sparkle icon (✦) is always visible on the right side of the Tags input field whenever the field is rendered. Hovering over it shows a tooltip: “AI suggests tags from your existing tags list.”
The tooltip is hover-only and disappears when you move away. The icon does not appear on any other field.
Requesting suggestions
Click the sparkle icon to start a scan. The field immediately:
- Disables — typing, removing existing tags, and interacting with the dropdown are all blocked while the scan runs
- Replaces the sparkle with a spinning circle loader in the same slot
Once the scan completes:
- A success toast appears at the top of the page: “Existing tags suggested based on the post”
- The Tags dropdown opens automatically
- The spinner converts to a Refresh icon in the same slot
Suggestion dropdown
The dropdown opens with two sections:
Click any tag in either section to apply it. Applied tags appear as pills in the Tags field with a remove (×) button. The dropdown stays open so you can keep adding tags.
Tags you have already applied are not suggested again in the same session.
Refreshing suggestions
After a successful scan, the sparkle icon becomes a locked Refresh icon. It stays locked until an autosave fires from any field other than Tags — at that point the icon becomes active and clickable.
Clicking an active Refresh icon re-runs the scan: the field disables, the spinner reappears, and a new set of suggestions is returned when complete.
Session reset: When you publish, save as draft, or reopen the post in a new session, the Refresh icon reverts to the sparkle icon so the entry point is always consistent.
Error states
If the scan cannot return suggestions, an error toast appears at the top of the page and the AI Suggests section shows an inline message. The Other Tags section remains fully populated and browsable in both cases.
UI states
Scope
AI Tag Suggestion is available on all post types where the Tags field is supported — Articles, Web Stories, and others.
It is not available on any other field. Title, Categories, Focus Keyphrase, and similar fields are out of scope for this release. Last modified on July 21, 2026
