Skip to content

Per-platform promotion fields: locations, YouTube SEO metadata, video alt text - #310

Open
gynsus wants to merge 3 commits into
trypostit:mainfrom
gynsus:pr/promotion-fields
Open

gynsus wants to merge 3 commits into
trypostit:mainfrom
gynsus:pr/promotion-fields

Conversation

@gynsus

@gynsus gynsus commented Aug 30, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #309 (auto first comment) — the two share PostPlatformMetaRules and the YouTube editor panel. Diff shrinks to just this feature once #309 merges.

Reworked for #397 (post_platforms merged into posts): publishers read the post's own meta, validation uses the prefix-parameterized meta keys and the editor panels read errors through useMetaErrors. The caption override this PR once carried is gone — independent social posts (#374) made every network's text its own post.

One post per network — but the fields that make a post promote well differ per network. This adds three per-platform capabilities, all stored in the post's meta, all validated centrally in PostPlatformMetaRules so the web editor, REST API, and MCP accept them equally.

Location tagging (Instagram + Facebook)

meta.location_id / meta.location_name tag IG feed/reel/carousel containers and FB feed/photo posts with a Facebook place. Meta closed place search to third-party apps, so the ID is entered by hand — the name field is just a human label. Stories and carousel children don't accept location_id (API limitation), and the publisher respects that.

YouTube SEO metadata

tags → snippet.tags, default_language, and recording_location {lat, lng, description} → recordingDetails — the upload request asks for snippet,status,recordingDetails parts accordingly (meta.title, category_id and the description are upstream's own fields now).

Video alt text (Mastodon + Bluesky)

Both accept media descriptions on video, but the alt editor only opened for images. It now opens for video items on the networks that support it, gated by a new supports_video_alt_text media rule; Mastodon sends it as the media description, Bluesky as embed.alt.

Testing

Meta persistence covered in PostApiPlatformMetaTest / PostPlatformMetaToolTest; publisher behavior in the Instagram (location on container), Mastodon (video alt), Facebook, Bluesky, and YouTube suites. All running in production on a self-hosted instance.

@gynsus
gynsus force-pushed the pr/promotion-fields branch 2 times, most recently from 9997ccf to 212dd06 Compare September 22, 2026 08:24
@gynsus gynsus closed this Sep 22, 2026
@gynsus gynsus reopened this Sep 22, 2026
@gynsus gynsus closed this Sep 22, 2026
@gynsus gynsus reopened this Sep 22, 2026
A per-channel meta.first_comment (≤2200, Instagram's comment limit) is
posted by FirstCommentPoster right after a successful publish — YouTube
via commentThreads.insert, Instagram via /{media}/comments. Failures
are logged and never fail the live post; Stories and in-review posts
get no comment. Connect flows request the comment scopes.

Reworked for the post_platforms-into-posts merge: the poster takes the
post itself and the rules use the prefix-parameterized meta keys.
…, video alt text

- Instagram/Facebook location_id (Facebook place ID, entered by hand
  since Meta closed place search) + location_name display label; tags
  feed/reel/carousel containers and page posts, never stories
- YouTube Shorts SEO: tags (≤30 of ≤100 chars), default_language
  (BCP-47) and recording_location {lat, lng, description}, sent through
  snippet and recordingDetails
- video alt text on the networks that support it (Bluesky, Mastodon),
  gated by the supports_video_alt_text media rule so the editor only
  offers the alt tab there

Reworked for the post_platforms-into-posts merge: publishers read the
post's own meta, rules use the prefix-parameterized keys and the panels
read errors through useMetaErrors.
@gynsus
gynsus force-pushed the pr/promotion-fields branch from 34f8778 to d9c6c9d Compare October 11, 2026 08:24
@gynsus gynsus changed the title Per-platform promotion fields: caption override, locations, YouTube SEO metadata, video alt text Per-platform promotion fields: locations, YouTube SEO metadata, video alt text Oct 11, 2026

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

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant