> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniwrites.com/llms.txt
> Use this file to discover all available pages before exploring further.
# X
> Connect X, publish posts and threads, and understand the text, image, GIF, video, Replies, and Articles limits that apply.
Use X in Omni Writes for single posts, multi-post threads, scheduled publishing, Calendar management, a mentions-based Replies inbox, and X Articles when entitlement and product flags allow.
This page covers X behavior in Omni Writes—connection, publishing, media, Replies, and Articles. Plan and billing details live under **Account → Billing**.
## Availability at a glance
| Capability | Available | Notes |
| ------------------------------- | --------- | -------------------------------------------------------------------------------------- |
| Text post | Yes | Publish now or schedule |
| Multi-post thread | Yes | Up to **11** posts in the composer |
| Images | Yes | Up to 4 per post |
| Video | Yes | 1 per post |
| Animated GIF | Yes | 1 per post (GIPHY picker or upload rules) |
| Mixed images and video | No | Choose photos, a GIF, or a video |
| Media alt text | Yes | Sent on publish; composer UI caps entry at **125** characters (API allows up to 1,000) |
| Calendar | Yes | Edit, cancel, publish now, retry |
| Replies | Yes | **Mentions inbox** + manual reply — not a Meta-style nested comment tree |
| X Articles | Optional | Qualifying X plan + deployment flag (`X_ARTICLES_ENABLED`; often off by default) |
| Ghost Mode | No | Threads-only feature |
| Polls, Spaces, DMs, Communities | No | Not in the current integration |
## Connect X
Go to **Settings → Channels** (or Connect Accounts). If X is not available yet, activate it from Channels first.
Choose **X**, start OAuth, and approve the permissions Omni Writes requests (including posting and media / `media.write`).
After redirect, confirm the connected `@username` appears as connected.
If long-form limits or Articles look wrong, use the X refresh / subscription controls on the channel card so Omni Writes re-reads your X plan from the API.
If Omni Writes shows **Reconnect Required**, reconnect from Channels before scheduling or publishing. An account connected before media permission was granted may also need a fresh reconnect before media posts succeed.
## Publish a post or thread
Select X in the composer, write the post, attach media, and choose **Publish now** or a future time. Use the thread composer for a chain (maximum **11** posts). Auto-split can break a long draft into multiple posts while staying inside that 11-post ceiling. Every post in a thread has its own text and media limits, and media belongs to the specific post where it was added.
## X Articles
Articles are a separate long-form surface from posts and threads. They appear in the composer only when the deployment enables them and your X account qualifies.
| Requirement | Detail |
| ------------ | ------------------------------------------------------------------------------- |
| Omni Writes | X connected and available on your account |
| X plan | Premium, Premium+, or verified Business / Government organization |
| Connection | Active X connection (not `requires_reauth`) |
| Product flag | `X_ARTICLES_ENABLED` must be on for the deployment (often **false** by default) |
| Verification | Eligibility comes from X API subscription metadata, not a manual tier override |
If Articles are hidden, confirm the flag, refresh X subscription data, or verify the connected account is on a qualifying X plan.
## Text limits
| X account state | X platform | Current Omni Writes |
| --------------------- | ----------------------: | ----------------------: |
| Standard | 280 weighted characters | 280 weighted characters |
| X Basic | Longer posts in X apps | 2,500 (product policy) |
| X Premium or Premium+ | Up to 25,000 | 25,000 |
X weights some Unicode characters differently. A standard post made entirely of CJK characters reaches the limit at about 140 visible characters (Premium CJK ceiling is lower than the full 25,000 weighted limit).
X's own apps may allow longer native videos. Omni Writes publishes through the X API, so the API media rules below apply.
## Media limits
| Media | X platform | Current Omni Writes |
| -------------- | --------------------------------------------- | ------------------------- |
| Photos | Up to 4 | Up to 4 |
| Photo size | 5 MB each | 4.5 MB each |
| Photo formats | JPG, PNG, GIF, WebP | JPG, JPEG, PNG, GIF, WebP |
| Animated GIF | 1, up to 15 MB | 1, up to 13.5 MB |
| Video | 1, up to 512 MB | 1, up to 512 MB |
| Video duration | 0.5–140 seconds | 0.5–140 seconds |
| Mixed media | Photos, GIF, and video are mutually exclusive | Not allowed |
Omni Writes keeps photos and GIFs slightly below X's upload maximum to reduce processing failures.
### GIF details
* Maximum 1280 × 1080 pixels.
* Maximum 350 frames.
* Width × height × frame count must not exceed 300,000,000 pixel-frames.
* A GIF cannot be combined with photos or video.
### Video details
* Dimensions: 32 × 32 through 1280 × 1024.
* Aspect ratio: 1:3 through 3:1.
* Frame rate: no more than 60 FPS.
* Recommended: MP4 with H.264 video and AAC-LC audio.
## Replies on X
With X connected, **Replies** loads a **mentions** inbox for that account so you can review and send manual replies. This is not the same as Facebook/Instagram nested comment trees. If mentions fail with a reconnect error, reconnect X and reload Replies.
## Media availability
A scheduled file must remain available until publishing completes. If X accepts an upload but rejects the final post, replace or re-export the invalid media before retrying from Calendar.
## Reconnect required
When X reports expired authorization, revoked access, or a missing permission, Omni Writes shows **Reconnect Required**. Reconnect from **Settings → Channels**, confirm the username, then retry the failed item from Calendar.
## Official references
* [X media upload best practices](https://docs.x.com/x-api/media/quickstart/best-practices)
* [X Premium and longer posts](https://help.x.com/en/using-x/x-premium)
* [Types of X posts](https://help.x.com/en/using-x/types-of-posts)
Follow the recovery checklist for authorization and media failures.