Bluesky Feed Creator

Help

You can use Bluesky Feed Creator to design, host and manage feeds on Bluesky.

A feed collects posts related to a specific topic of your choosing, and displays them in one list.

When you set up a new feed, it will begin monitoring Bluesky, looking for any new posts matching your keywords. When it finds one, it will insert it into your feed.

Getting Started

Once you have an account on BlueskyFeedCreator.com, connect your Bluesky account. You can do this by visiting the "Settings" area and pressing "Add New Account". Feeds cannot be created without a connected Bluesky account.

Once your account is connected, your feed can be published to your profile. This makes it visible to all Bluesky users.

Adding a new Account

To add a new account, you will need to fill in your Bluesky username (e.g. fyodork.bsky.nz), and then press "Connect To Bluesky". This will redirect you Bluesky's own login page, where you will need to enter your Bluesky password and then authorise the connection.

../assets/Pasted image 20241023095650.png

Once you have done this correctly, you will see a success message. An example is pictured below.

../assets/Pasted image 20241023100020.png

Creating a Feed

When you have connected a Bluesky account, you can then create a new feed. Visit the "My Feeds" area and press "Add new feed".

The required fields you need to fill in are:

assets/Pasted image 20240330125040.png

Feed Path

This forms part of the public URL (website address) of your feed, combined with your Bluesky handle. A good idea is to keep it short so it's easily memorable, e.g. "nzpets" - but it can be up to 15 characters long.

Public Information

In this area, Bluesky users can see the feed title, description and avatar. These are all shown within the Bluesky app itself, and help people search for and identify your feed.

"Publishing" to Bluesky is when you update the public information (title, description or avatar) of your feed in the Bluesky app. If you want to change the public information of your feed, you will also need to click the "Save and publish" button in Bluesky Feed Creator, so that the information is also updated in the Bluesky app.

Should you need to force your public information to publish to Bluesky, you can change the text in either the title or description box - then the "Save and publish" button will become blue so you can click it.

assets/Pasted image 20240330130216.png

Public Description Page

Every feed hosted on BlueskyFeedCreator.com has an additional public description page, separate to the Bluesky app. You do not have to share the link to it, but it can be a useful landing page for Bluesky users looking for more details about your feed.

You can format the page using Markdown. You can use an online markdown editor to design it.

Some details you could include are:

assets/Pasted image 20240330130404.png

Capturing Posts

When Bluesky Feed Creator puts a post into a feed, it's referred to as "capturing".
As the feed owner, you set the parameters for how capturing happens by using excluded terms and included terms.

The service works like this:

Unless you use wildcards or emojis, included and excluded terms are always whole words with either spaces or punctuation on either side of them.

When using emojis or emoji sequences as a term for including or excluding, posts will be excluded or included if they have emojis or emoji sequences matching the term - regardless of whether they have spaces, other characters or punctuation on either side of them.

There is no option to use regex (regular expressions).

Both the post text and any alt-text on images or GIFs are considered when searching for inclusions or exclusions. Text inside a quoted post is not considered.

You can use Bluesky Labels in your exclude area to remove all posts with certain content warnings (e.g. nsfw, porn, nudity, sexual).
Use the special keyword label:* to exclude posts with any content warning labels.
Use the special keyword label:none to exclude posts with no content warning labels.

You can choose to exclude some or all posts with these content warnings.
You can exclude one content warning at a time by adding, for example, 'nsfw' to your excludes - you do not have to use the label: prefix for excluding one content warning type at a time.

Supports self applied labels and automatic Bluesky Moderation Service labels.

You can include every post from a specific user, by using a search term in the format from:@handle. This might be useful if for example you were running a feed for a conference, and you wanted to search for the conference hashtag from the general public, but include all posts the official conference account. For example: from:@bsky.app

Comments can be included by using the -- sequence. Anything after the -- sequence is ignored by the service. This might be useful if you want to include a reason for your search term.

Wildcards

You can use the * character as a wildcard, to match words that start or end with specific characters.
For example, you could match all words that start with "sci" by using the term sci*, or match all words that finish with "ing", by using the keyword *ing. Wildcards can also be inserted inside a word, or used to find hashtags. For example #sci* would find all hashtags starting with "#sci".
A wildcard will also match the term on its own as if it didn't have a wildcard, so science* will match the word "science" as well as "sciences".

You can also use wildcards to match between words.
For this, you need to surround your * character with a space on each side.
For example, if you wanted your feed to include posts such as "visiting Civic Theatre" but also "visiting the Court Theatre" and "visiting Basement Theatre" then you could use a wildcard term like visiting * Theatre. This would collect all of the posts named above as well as any others where different theatres were named.
Note that this would also collect "visiting my aunt and going to the Theatre".

Requiring Approval

You can choose to manually approve posts before they are shown in a public feed.
Some examples of rules you could use to determine whether a post requires approval are:

Posts which require approval will show up in the settings page for your Feed, alongside all the automatically included posts. You can choose to approve or deny them.

assets/Pasted image 20240330130527.png

Feed Moderation

There are many ways to curate and moderate the posts which come into your feed. We have compiled a case study to show you all the options available to you to get your feed just the way you want.

Populating a new feed

You can manually add a post, which is at the bottom of your individual feed dash.

You just need to grab a link to the post you want to include and drop it into the pop up box that appears when you click Insert post manually.
../assets/Pasted image 20241120101721.png
In the Tools area you can use the Query a user’s posts tool to look at any user’s 50 most recent posts and add whichever are relevant according to your Capturing posts terms.

This is great for when you have a few power users for one feed, whose posts are likely to be included a lot.

It looks like this:

../assets/Pasted image 20241120101937.png
You can add the handle of an account you want to use this for, select your feed in the second box and then click Query user. It'll look at their 50 most recent posts and add whichever are relevant according to your Capturing posts terms.

Restricted Feeds

By default, feeds you create will be 'unrestricted'. This means they will capture posts from all users in the Bluesky network.
You may choose to make a feed 'restricted' instead, which means a post will only be captured if you have previously approved its author to post to that feed.

This feature can be used to create more tight knit community feeds, or even feeds that look at a single user's posts.

assets/Pasted image 20240330130621.png

Invite Requests

If you want to make a restricted feed, where users have to request to be allowed to post in the feed, you can do that by:
../assets/Pasted image 20241115124727.png
Setting the toggle above (which is found in your main feed dashboard with the settings to Include replies etc.) to Capture posts from specific users. You will then need to click Save.

Then, pin a post - any post will be fine, but some people like to pin a post with instructions such as “Reply to this post with this emoji sequence”.

When a person replies to the pinned post in your restricted feed, you will receive an invite requested notification in Bluesky Feed Creator. 

It will show up on your main dashboard like this:

../assets/Pasted image 20241115124810.png

And in your individual feed dashboard like this:

../assets/Pasted image 20241115124935.png

Both the 1 invites requested and 1 user(s) links are clickable and will take you to where you can approve or deny the users requesting to be allowed to post.

Advanced Usage

If you are running a restricted feed, you may get questions from people who want to know if they can post in the feed or not. You can add a special shortcode to your public description page. People can then enter their Bluesky handle in a special box to check whether they can post in the feed, without having to ask you.

To do this, just enter the shortcode [user-searcher] anywhere in your markdown.

assets/Pasted image 20240330130734.png
assets/Pasted image 20240330130831.png

Synced Lists

You can subscribe to public Bluesky "lists" to allow or block users in bulk, instead of allowing or blocking individual users manually. You may have your own lists that you manage, or you could use lists that other people have shared.

This feature can be used to create feeds which have a large number of pre-approved users already enabled (e.g. a public list of authors).

You can use lists for blocking users as well.

Synced lists can be managed from your main menu on the left, or from within an individual feed's "Allowed users" area.

Lists will be automatically re-synced if they are more than 24 hours out of date, or you can use the "Sync all" button.

The users in a list will only be allowed or blocked in your feed as of the most recent sync time.
If you add new users to your list, they will only be able to post in your feed once you have pressed the "Save and sync list" button on the Bluesky Feed Creator website.

assets/Pasted image 20240330130916.png

Making a feed using a starter pack as a synced list

You can use a starter pack as a synced list and make a feed based on it, where all the users on the starter pack are allowed users for posting in your feed.

Find the starter pack you want to use, then use the buttons below to get a link to it. First, click the three dots 'more' menu, then 'Share link'. On the next box which pops up, click 'Share link' again.

../assets/Pasted image 20241025144308.png
In Bluesky Feed Creator, click on 'My synced lists' and then 'Import list'.
Copy the link you grabbed before into the 'Enter list or starter pack link' box.

../assets/Pasted image 20241028105055.png

../assets/Pasted image 20241028105330.png

Here, we can see the Tech Folks starter pack inside the 'My synced lists' area. The starter pack is now a synced list which can be used to allow, or block users from posting in a feed. 

You choose whether it’s an allow list or a blocking list using the 'List intent' function at the top. Right now, this will apply across all your feeds.

Now, go to the feed you want to use the starter pack. If it’s a brand new one just for this starter pack, you will need to create it. First, set the feed to only capture posts from specific users, then save the feed settings:
../assets/Pasted image 20241120101200.png

Now you will find the button to 'Manage allowed users and lists'. Click this, and select the starter pack list you added before.

../assets/Pasted image 20241120101341.png

Collecting all posts from users on the list

To make a feed which collects all posts from users on the starter pack list, you would put only an asterisk (*) into the 'Search for words or tags in posts' box. The asterisk works as a wildcard, so this will collect everything they post.

You can use the wildcard asterisk and still exclude selected posts if you want - you would use the 'Exclude words, tags or labels in posts' as usual.

You can also run a feed which is curated as usual, with included and excluded terms, but have the starter pack synced list as the base list of users which it can collect posts from (as opposed to the entire Bluesky user population).

Auto Moderator

You can set up Auto Moderator rules to automatically perform actions on your captured posts.
For example: Deleting or hiding, and actioning "requires approval" statuses.

Detailed help and example rules can be found in the Auto Moderator Help

How To

Importing a Feed from another service

If you enter the feed path of a feed which already exists in your profile, but is hosted on another service, we will automatically download the existing posts and insert them in to your new feed when you save it.
The feed path that you enter needs to be identical to the one you used on the other service.

When you publish the feed from Bluesky Feed Creator, it will replace your existing feed.

Your feed's followers will not notice anything. All existing likes and saves will still be present and the URL (website address) for your feed will still work.

Changing your Bluesky Handle

If you change your Bluesky Handle, your feeds will still be published on your account without you having to do anything.
However, your old credentials will no longer be valid. You will be unable to publish updates to your feed. To rectify this, you need to add a second "Account" in your "Settings" area with your new handle and a new app password.

Once the account is connected again, you can update each of your feeds' settings to publish under the new account.

Your feed's followers will not notice anything. All existing likes and saves will still be present and the URL (website address) for your feed will still work.