# Troubleshooting

Fix common problems with publishing, channels, media uploads, and sign-in.

Most issues have a safe, self-serve fix. Work through the symptom you're seeing below — none of these steps delete your posts or drafts.

## Publishing

### The action buttons are disabled in the composer

- **Select a Brand Profile** in the toolbar or composer. The "All Brand Profiles" view can't publish — the composer shows a banner asking you to choose one.
- **Select at least one destination channel** in the Destinations bar. If the bar is empty, connect a channel on the [Channels](/docs/channels) screen first.
- If you're editing a post and see "This post belongs to…", the post was created under a different Brand Profile — switch the Brand Profile dropdown selection to the profile named in the banner.

### A channel can't be selected in Destinations

Unavailable channels show a label on their pill:

- **Expired** — the platform login needs renewal. Go to [Channels](/docs/channels) and use **Re-authenticate** on that account.
- **Disabled** — the channel was disconnected or its access revoked. Reconnect it from [Channels](/docs/channels).
- **Incomplete** — the connection flow wasn't finished. Re-run the connection.

Hover the pill to see the reason.

### The composer lists errors when I submit

The banner lists every problem to fix before submitting. Common ones:

- **Empty post** — add text or at least one media item.
- **Media limit or type error** — the destination channel limits how many attachments can be published or restricts combining media types. Adjust the channel's attachment selection or deselect that channel.
- **Text too long** — the channel's platform caption limit is shown in the message; shorten that channel's text (use **Customize for This Channel** to shorten just one).
- **YouTube** — add a Video Title between 2 and 100 characters and keep tags within the limits.
- **TikTok** — pick a Privacy Level; if a toggle (Duet, Stitch, Comments) is blocked, that account doesn't allow it.
- **Media type** — the attached file isn't accepted by that channel (for example, a video where the platform expects an image); swap the media or deselect that channel.

If submission itself fails, everything you wrote is kept — fix the cause and submit again.

### Media constraints block scheduling or publishing

Each platform enforces media limits (such as single-video restrictions or maximum attachment counts). Switch to the channel's tab in the composer to review its attachment selection and adjust which files are included.

### My post is stuck on Queued, Processing, or Awaiting provider

These are normal in-progress states — posts update automatically while delivery is in flight, so give it a moment. If a channel sits there for an extended time, open the post details and **check whether the post actually went live on that platform first**. You can then use **Cancel** for that channel: cancellation is a request for an in-flight delivery, not a guaranteed stop, so verify on the platform before publishing the post again.

### A post failed to publish

1. Open the post and read the failure reason on the failed channel.
2. Use **Retry** on that channel — retrying only re-queues the failed channel, not the ones that published. If the failure isn't retryable, Meltiply refuses the retry and the failure stays; fix the cause (for example the channel's connection) and submit the post again instead.
3. If it fails again, check the channel itself: an expired or revoked connection blocks delivery. Re-authenticate on [Channels](/docs/channels), then retry.

### A post says "Needs reconciliation"

The outcome couldn't be confirmed with the platform — the post may or may not have been published. **Check the post on the platform itself before doing anything else**, otherwise you could publish a duplicate. If it didn't go live, cancel the unconfirmed delivery and submit the post again (for example by editing it and re-scheduling).

### I can't edit or delete a post

Only drafts and posts with pending or unconfirmed channels can be edited, rescheduled, or cancelled. Published posts can't be edited or deleted from Meltiply — remove them on the platform. Cancelling never pulls down already-published channels; it only stops the pending ones, and for an in-flight delivery it is a request rather than a guaranteed stop.

### My draft disappeared

Drafts live under the **Drafts** status filter in [Posts](/docs/publishing). If you scheduled or published a post that used the draft, the draft version is replaced by the real post. If you can't find it at all, check the Brand Profile filter — drafts only show under the profile they were written for.

## Channels

### Connecting a channel fails

Connecting redirects you to the platform to approve access, then returns you to Meltiply. Facebook opens a Page chooser: select a Page and **Connect Page** before expecting it on [Channels](/docs/channels). No eligible Pages means the required publishing permissions or Page access are missing. A connection-limit error requires disconnecting an account or upgrading the verified plan; retry the chosen Page while the selection remains valid. Expired selections require starting **Connect** again.

If you cancelled the provider's permission prompt or authorization failed, run **Connect** or **Re-authenticate** again. A platform that can't be connected right now reports that its connection isn't available yet; try again later.

## Audience interactions and comments

The application does not currently expose an in-app inbox interface. The backend comment syncing capabilities and platform endpoints remain intact, but audience comments and replies should be managed directly on each connected social platform.

For information on comment processing, see [Inbox](/docs/inbox).

## Performance analytics

The application does not currently feature an in-app analytics dashboard. The backend metrics sync endpoints remain active, while live impressions, engagement, and post reach can be monitored directly on the native platform dashboards.

For details on how analytics processing operates, see [Analytics](/docs/analytics).

## Media and uploads

If an upload fails, the attachment card shows a failed status in the composer and an error toast appears. Common causes are an interrupted network connection or exceeding your plan's upload quotas (see [Billing](/docs/billing)). You can select **Retry** directly on the attachment card using the local file, or re-attach the file. See [Media](/docs/media).

## App-level errors

Banners and errors you'll see anywhere in the app:

- **"You are offline"** — your connection dropped; changes are paused until it returns.
- **"Your session expired"** — sign in again; your posts and drafts are unaffected.
- **"Your session no longer has access to this workspace"** — your access changed; sign in again or ask the workspace owner about your membership.
- **"Meltiply is temporarily unavailable"** — maintenance or an outage; try again later.
- **"Meltiply could not refresh this view"** — a screen failed to load; use **Try again** on the error panel or reload the page.
- **"An error has occurred."** — a generic failure; retry the action.
- **"Too many requests. Wait a moment and try again."** — rate limiting; pause briefly and retry.
- **"This changed while you were working. Refresh and try again."** — something was edited elsewhere (another tab or teammate); reload the screen and redo your change.
- **"Your storage or upload quota has been reached."** — check [Billing](/docs/billing) for plan quotas and backend limits.
- **"That item is no longer available."** — the post, draft, or asset was deleted since you opened it; go back to the list.
- **"Choose an active workspace to continue."** — the app does not offer an in-app workspace switcher; reload the page, then sign out and back in so your session can resolve a workspace again.

## Still stuck?

If a problem persists: reload the page, then sign out and back in. For failed posts use the built-in **Retry** in the post details. If nothing works, contact support with a description of what you tried.
