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

# Bluesky

> Connect Bluesky with an app password, what you can post, and its limits.

Bluesky is the one network that doesn't use a sign-in page. You connect it with your handle and an **app password** — a separate password you generate in Bluesky, which you can revoke at any time without changing your account password.

## Before you start

Generate an app password in Bluesky under **Settings → App passwords**. It looks like `xxxx-xxxx-xxxx-xxxx`.

Never enter your account password. Ocoya asks for an app password specifically so it never holds full access to your account.

## Connect Bluesky

<Steps>
  <Step title="Open Channels">
    Select **Channels** in the left sidebar, then **Connect channel**.
  </Step>

  <Step title="Choose Bluesky">
    Pick **Bluesky** from the **Add a connection** panel.

    <Frame caption="Bluesky in the Add a connection panel.">
      <img src="https://mintcdn.com/ocoya/AXU_TbAvrsHP8A-m/images/screenshots/channels-connect-drawer.png?fit=max&auto=format&n=AXU_TbAvrsHP8A-m&q=85&s=fb49d994bcc630972a670a1277c36d2c" alt="Add a connection panel listing every channel Ocoya connects to, each with its category and an arrow to continue" width="864" height="2648" data-path="images/screenshots/channels-connect-drawer.png" />
    </Frame>
  </Step>

  <Step title="Enter your handle">
    Your handle is under your display name on your Bluesky profile — usually `yourname.bsky.social`. Custom domain handles work too.
  </Step>

  <Step title="Paste the app password">
    Paste the app password you generated, then select **Connect Bluesky**.
  </Step>
</Steps>

There's also a **Follow us on Bluesky** checkbox, ticked by default. Clear it if you'd rather not.

## What you can post

| Post type    | Supported             |
| ------------ | --------------------- |
| Text post    | Yes — no image needed |
| Single image | Yes                   |
| Carousel     | Yes — up to 4 images  |
| Video        | No                    |
| GIF          | No                    |

## Bluesky's limits

|                 | Limit                                |
| --------------- | ------------------------------------ |
| Post text       | 300 characters per post, 5,000 total |
| Hashtags        | No fixed limit                       |
| Images per post | 4, maximum 2 MB each                 |
| Video           | Not supported                        |

**2 MB per image is the tightest image limit of any network Ocoya supports.** A photo straight off a phone is usually larger, so compress before uploading if Bluesky rejects it.

## Long captions become threads

Bluesky holds 300 characters per post. Above that, Ocoya splits your caption into a thread rather than refusing it, up to 5,000 characters total. See [Long posts and threads](/help/long-posts-and-threads).

## Common problems

**"Could not connect Bluesky."** Almost always the account password rather than an app password, or a typo in the handle. Generate a fresh app password and try again.

**"It worked, then stopped."** Revoking the app password in Bluesky disconnects Ocoya. Generate a new one and reconnect — see [Reconnect a channel](/help/reconnect-a-channel).

**"My video won't attach."** Bluesky publishing is image-only in Ocoya. Post the video to another channel, or share a link.

## Related

<Columns cols={2}>
  <Card title="Long posts and threads" icon="list" href="/help/long-posts-and-threads">
    When a caption is split into a chain of replies.
  </Card>

  <Card title="Reconnect a channel" icon="refresh-cw" href="/help/reconnect-a-channel">
    Restoring access after an app password is revoked.
  </Card>
</Columns>