> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.shipcontent.com/llms.txt
> Use this file to discover all available pages before exploring further.

---
title: Post to several platforms
description: Write one post, add platforms, publish to all at once, read each result and retry one failed platform alone.
section: workflows
order: 25
status: implemented
mode: both
reviewed: 2026-11-04
sources: [src/lib/marketing/post-sets.ts, src/components/marketing/multi-platform-progress.tsx, src/components/marketing/multi-platform-accounts.ts, src/lib/marketing/post-text-issues.ts, src/components/marketing/multi-platform-chips.tsx, src/components/marketing/multi-platform-tabs.tsx, src/components/marketing/multi-platform-publish-area.tsx, src/components/marketing/multi-platform-published.tsx, src/components/marketing/multi-platform-result-card.tsx, src/components/marketing/multi-platform-post-row.tsx, src/components/marketing/post-account-choices.tsx, src/components/motion/create-posts-panel.tsx, src/components/motion/export-view.tsx, db/publishing.sql, src/lib/server/marketing/marketing-agent-tools.ts, src/lib/mcp/agent-tools.ts, src/lib/server/marketing/PostSetPublishing.ts, src/lib/server/marketing/post-set-publish-checks.ts, src/lib/server/review/review-edit.ts, src/components/owner/post-review-multi-publish.ts]
tools: [cross_post, get_post]
next: [/docs/workflows/post-draft, /docs/contracts/errors, /docs/contracts/request-ids]
---
One finished post can go to several platforms. Each platform gets its own version of the post. A version is an ordinary post: it has its own approval and its own delivery result. The versions of one post form a set. Each platform has one current version: the newest version on that platform that is not archived. The owner sees the set as one **Multi-platform post**.

## Owner steps

1. **Start with more accounts.** In **Create post**, select more than one account in the **Account** step, then select **Continue**. The app makes one draft for each account and opens the first one. If it cannot add a platform, the first draft still opens and shows which platform failed. Add it with **+ Add platform**.
2. **Or add a platform later.** In a post, select **+ Add platform** and choose a connected account. The list shows only the accounts that can publish the format of the post. The post becomes a multi-platform post.
3. **Edit once.** Under **Posting to**, each platform has a chip. Edit the text and media of the open post. Publish copies them into the other drafts. A × on a draft chip removes that platform from the post. A platform that was sent has no ×. A draft that an agent added shows **Added by your agent**.
4. **Check each platform.** Each platform has a preview tab. It shows the connected account that version publishes to, for example an Instagram username or a Facebook Page name. Without a connected account it shows the workspace name. A tab with an issue shows a mark. A text check shows where the text breaks a platform rule, for example "X: 312 / 280". TikTok allows 30 mentions and 2,200 characters: when the text is longer, TikTok shows "text will be cut", and only the TikTok version gets the shorter text. A platform can need its own setup, for example the YouTube title, privacy and audience, or the TikTok settings. Set it in its tab.
5. **Publish.** Select **Publish to {n} platforms**. When the post has a planned date, the button reads **Schedule for {n} platforms**. If a tab has an issue, the button opens that tab and sends nothing. Publish sends only the platforms you see. If an agent or another window added or removed a platform since you looked, nothing is sent and a message names the platform: check the platforms, then select **Publish** again. Each platform then publishes on its own: a chip shows a spinner, then a check and a link to the post. Under the lock message, a list shows each platform with its account: a spinner while it sends, a check and **View** when it is live, **Failed** and **Retry** when it fails. One platform can fail while the others succeed. While a platform publishes, the owner cannot change the post: the text, the media, **+ Add platform** and the Publish button are off. An agent cannot change a version that publishes (`DRAFT_LOCKED`). The owner can change the post again when no platform is publishing.

Updated 2026-10-28. A platform that moved to another channel counts as removed and added. If the post changed after you opened it, for example an agent changed the text, nothing is sent and the page reads the post again: check it, then select **Publish** again. Your own edits do not stop Publish: Publish saves them first.

To cancel scheduled platforms, select **Cancel schedule**.

Updated 2026-11-04. Every platform of a multi-platform post can be scheduled. Instagram, YouTube, X, Facebook and Threads scheduling is always on for a connected account. No flag controls it. A schedule is not a delivery receipt. See [Facebook](/docs/channels/facebook#scheduled-delivery), [Threads](/docs/channels/threads#scheduled-delivery), [Instagram](/docs/channels/instagram#scheduled-delivery), [X](/docs/channels/x#scheduled-delivery), [YouTube](/docs/channels/youtube#scheduled-delivery) and [TikTok](/docs/channels/tiktok).

## Studio export

In Studio, **Create posts** makes one version for each connected platform that the format publishes to. **Create N drafts** opens the multi-platform post. See [Studio projects](/docs/workflows/videos).

## After publishing

When no platform is waiting, the post shows one result card for each platform:

- **Published** and the time, with **Views**, **Likes** and **Comments**. A dash means the platform gives no number or the number is not read yet. **View on {Platform}** opens the post.
- **Failed** and the error, with **Retry {Platform}**. Retry makes a new draft of the failed version. It keeps the text that you changed for that platform. The failed version stays as an earlier attempt, and nobody can change or send it. Publish the new draft again. The platforms that published are not sent again.
- **Not confirmed**: the result is unknown. Wait. Do not publish again. After 24 hours, the owner can select **Not live, retry**. Check the platform first: if the post is live, a retry posts it twice.

In **Posts**, a multi-platform post is one row with a status line for each platform. Select a platform line to open its tab.

## Agent steps

Agents publish one version at a time. There is no publish-to-all tool.

1. Call `cross_post` with a stable `requestId`, the `postId` and `channels`. After a lost response, send the same ID and identical input to get the same versions.
2. Give the owner `review.url`. The owner publishes the versions. The owner sees each version that you add with the label **Added by your agent**, and Publish stops once if you add one or change the post after the owner looked.
3. Read `get_post`. Its `set` field lists each version with `channel`, `deliveryStatus` and `current`.
4. To retry a failed version, call `cross_post` with that version's `postId` and its channel. An agent never retries an unknown result.

A refused channel makes no drafts. The error lists each refused channel: see [cross-posting errors](/docs/contracts/errors#cross-posting-errors).
