Skeeters, rejoice! Buttondown lets you connect your Bluesky account to your newsletter in Buttondown. This lets you automatically cross-post your newsletter emails to Bluesky. This function is powered by our automations feature.
To automatically cross-post your newsletter emails to Bluesky, you have to complete two steps:
Setting up your Bluesky integration
First, you must connect your Bluesky and Buttondown accounts. This requires two steps:
- Generating an app-specific password in Bluesky
- Connecting your Bluesky account to Buttondown
#1. Generating an app-specific password in Bluesky
Bluesky requires you to generate an app-specific password for each app/integration that you connect to your account. This is different than your account password.
To generate this app-specific password:
- Log into your Bluesky account
- Navigate to Settings → App Passwords
- Click Add app password and follow the prompts to create a new password.
- Copy the newly generated app password and save it somewhere secure.
You will not be able to view the app-specific password after you dismiss the screen in Bluesky. When you are prompted to copy the app password, copy it and save it somewhere secure.
#2. Connecting your Bluesky account to Buttondown
Now you can use the app-specific password you created to connect to your Buttondown newsletter. Here's how:
- Log into your Buttondown account
- Navigate to Settings → Integrations.
- Find the "Bluesky" integration option and click Configure. The Bluesky configuration panel opens.
- Enter your Bluesky username in the appropriate field.
- Paste your generated App-specific password in the appropriate field.
- Click Save changes.
The app-specific password is NOT your Bluesky account password.
Sharing your newsletters to Bluesky
To share your newsletters to Bluesky, you can create an automation that posts your newsletters to Bluesky whenever you send them. To do this, create a new Automation, or just click the Automation banner below:
The simplest and most common use case is to create an automation that posts your newsletters to Bluesky whenever you send them. Here's how:
- Navigate to the Automations page and click New. The "New automation" panel opens.
- (Optional) Give your automation a human-readable "Name."
- Set the Trigger to when an email is sent.
- Set the Action to Create a Bluesky post.
- (Optional) Configure any other fields to customize the automation. If you leave these fields blank, the automation will post to your Bluesky account as soon as you send a new newsletter email.
- Click Save changes.
To enable the new automation, either click Unpause in the automation panel, or click to enable the automation's toggle in the Automations page.
Enhanced link cards
By default, a Buttondown archive link posted to Bluesky shows up as a plain link card. Buttondown can upgrade these to enhanced link cards — a richer format that shows your publication's name, avatar, and a themed cover.
These cards are powered by standard.site, a community-built way of describing publications on Bluesky. Once you turn them on, they apply both to links Buttondown posts automatically and to archive links you (or your readers) paste in by hand.
Requirements
- Your Bluesky account is connected to Buttondown.
- Your newsletter's archive is public. An email only gets an enhanced card while it's publicly archived.
Turning on enhanced link cards
- Navigate to Settings → Integrations and open the Bluesky integration.
- Under Enhanced link cards, click Create publication.
Buttondown then adds a small entry to your Bluesky account describing your publication, plus one for each publicly-archived email. From then on, new posts and freshly-shared links show up as enhanced cards.
Bluesky locks in a card's appearance at the moment it's posted, so enhanced cards only apply to future posts and shares — links you've already posted keep the card they had.
Keeping it in sync
If your newsletter's name, description, or icon changes, the Bluesky integration flags that your details have drifted since the last sync. Click Sync now to update your publication record. Already-posted cards don't change — this only affects future posts and shares.
If your archive's web address changes — for example, when you add and verify a custom domain — Buttondown re-syncs automatically once the new domain is verified, so future cards keep working.
Disconnecting
Click Disconnect under Enhanced link cards to stop managing your standard.site publication. Buttondown leaves the records already in your Bluesky account in place, so cards you've already posted keep working; it simply stops creating and updating them.
Enhanced link cards are published to your own Bluesky account and are publicly visible. Each record carries only enough to identify an article and link back to it — its title and a short description, never the body of your email.