Bluesky Autopost (Per Author)

A WordPress plugin that lets each author connect to their Bluesky account.

Updated March 20, 2026 (version 1.2.0) | How to install or update safely

Let each author at your WordPress website connect to their Bluesky account. When they publish a post, it is sent to their Bluesky account. (There is a 1 to 2+ minute delay depending on whether a token has expired and/or if something like the image upload fails at first.)

Here’s how it works

1. Connecting Bluesky Account

Each author can connect their Bluesky account by using the provided shortcode [bsky_connect]. This renders a connection form for the author to connect or disconnect their Bluesky account.

2. Scheduling Auto-Post

When a post is published, the plugin schedules an auto-post to Bluesky with a delay of 1 minute using the wilcosky_bsky_schedule_auto_post function.

3. Auto-Posting to Bluesky

The wilcosky_bsky_auto_post function is triggered to perform the following steps:

  1. Check Post Status: Ensure the post is published and not already posted.
  2. Retrieve Post and User Meta: Get the post details and user meta information.
  3. Check Open Graph Data: Retrieve Open Graph data (title, description, and image) from the post link.
  4. Upload Image (if available): If an Open Graph image is found, upload it to Bluesky.
  5. Prepare Post Data: Prepare the data for posting, including text and embed (if image is uploaded).
  6. Post to Bluesky: Attempt to post the data to Bluesky.
  7. Token Handling: If the token is expired, the refresh token is used. If the refresh token is also expired, re-authentication is performed.

4. Retry Mechanism

If the initial posting attempt fails:

  1. First Attempt: The plugin will try to post again after a short delay.
  2. Second Attempt: If the first retry fails, it will attempt again.
  3. Third Attempt: As a foolproof mechanism, a third attempt will be made.

5. Frontend Log

Authors can view a log of their auto-post attempts, including any errors or successful posts, directly from the frontend.

6. Disconnecting Bluesky Account

Authors can disconnect their Bluesky account using the disconnect form rendered by the [bsky_connect] shortcode. This will remove all stored session tokens and credentials.

Now, each author at your multi-author blog can send their posts to their Bluesky account.


Changelog

March 2026 – v1.2.0

  • Bluesky API changes
  • Upgrading logging

April 2025 – v1.1.0

  • Stable, well-tested version launched
Billy Wilcosky