Skip to content

Docs: Personalization failed badge for multi-location posts (SM-4194)#799

Draft
haleyserrano wants to merge 1 commit into
masterfrom
claude/epic-noether-xzkw9j
Draft

Docs: Personalization failed badge for multi-location posts (SM-4194)#799
haleyserrano wants to merge 1 commit into
masterfrom
claude/epic-noether-xzkw9j

Conversation

@haleyserrano

@haleyserrano haleyserrano commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

JIRA

SM-4194 — Localization - Personalization failed and Tooltip

Classification

UI/UX change — new error state (badge + tooltip) for multi-location social posts.

Repo targeted

Business App (end-user documentation)

Summary of updates

Updated the existing Managing Posts from Business App article (docusaurus/docs/social-marketing/posts/manage-posts-in-business-app-social.mdx):

  • Added a bullet to the existing warnings callout documenting the Personalization failed badge that appears on a multi-location post when personalizing content for one or more locations fails, including the exact tooltip copy.
  • Added a matching FAQ entry.

Existing docs updated vs. new docs created

Updated existing documentation. No new page was created — this is a new error/status state on the same "Manage Posts" surface that the article already documents (drafts/scheduled/published statuses, validation errors, deletion).

Placement reasoning

The article already has a warnings callout covering post-level validation errors and a "Points to remember" section with an FAQ block, so the new badge behavior was added alongside the existing content/media validation bullet rather than as a new section or page.

Acceptance criteria coverage

  1. "Personalization failed" badge displayed on the post — documented.
  2. Tooltip text on hover — documented verbatim.
  3. Applicable to web and mobile — documented.
  4. Applicable to multi-location only — documented (feature is scoped to multi-location posts; no ML-internal terminology used per gray-label rules).

Figma / images

None provided directly on the ticket usable here (two Jira attachments show the production UI, but they aren't accessible as image assets for this repo). Documentation is text-based per the acceptance criteria and confirmed via ticket comments describing the production behavior.

Skills used

  • pre-push-validation (tag/frontmatter/link checks — passed)

Assumptions / limitations

  • The parent epic (SM-1337, "UX Improvements — Social Marketing & Business App Social") is not marked Done and is a large, ongoing umbrella epic (~95 linked tickets spanning many unrelated features). No sibling tickets under it show feature-flag/eligibility/rollout-gating signals for this specific personalization-failure badge. The story itself is Done, and ticket comments from the developer confirm the change is live in production ("The changes has been moved to production..."). Documented as live on that basis.
  • Per the linked PR (vendasta/galaxy#33519), edit/schedule actions are hidden for posts in this failed state — only delete-and-recreate is supported. This is reflected in the wording.
  • No screenshot was added since the Jira attachments weren't accessible as image files for this repo.

cc @ahnikakuse @haleyserrano @maryam6samadi


Generated by Claude Code

…SM-4194)

Multi-location posts that fail to personalize content for one or more
locations now display a "Personalization failed" badge with a tooltip
explaining that the post must be deleted and recreated.
@haleyserrano
haleyserrano requested a review from ar-av-i July 24, 2026 10:39
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.

2 participants