Allow-Listing

The Allow-Listing feature grants pod moderators and administrators greater control over federation by allowing you to create a pod-wide allow-list.

When allow-listing is enabled, your pod’s users will only be able to interact with pods included in the allow-list. Any messages, activity, uploads, or modifications to libraries and playlists will only be shared with pods on the allow-list. Pods which are not included in the allow-list will not have access to your pod’s content or messages and will not be able to send anything to your pod.

Enabling Allow-Listing

Warning

If your pod is already federating proceed with caution. Enabling the Allow-Listing feature will initially block all activity from external domains as the list will be empty

To enable allow-listing:

  • Navigate to the “Settings” menu

  • Go to the “Moderation” section

  • Toggle the “Enable allow-listing” radio button

  • Click “Save” to commit the change

Once enabled, you can start adding domains to your allow-list.

Adding/Removing Domains

Add a New Domain

  • Navigate to the “Moderation” menu. Any domains currently in the allow-list will be visible here with a green check mark next to their name. Other pods with which you have previously interacted will also be visible here

  • Type the domain name of the pod you wish to allow into the “Add a Domain” input box in the top-right of the screen

  • Tick the “Add to allow-list” tickbox

  • Click “Add” to add the domain

Add a Known Domain

  • Navigate to the “Moderation” menu. Any domains currently in the allow-list will be visible here with a green check mark next to their name. Other pods with which you have previously interacted will also be visible here

  • Click on the tickbox next to the domain(s) you wish to add to the allow-list

  • Select “Add to allow-list” from the drop-down menu titled “Actions” and click “Go” to add the domain(s)

Remove a Domain

To remove a domain from the allow-list:

  • Navigate to the “Moderation” menu. Any domains currently in the allow-list will be visible here with a green check mark next to their name. Other pods with which you have previously interacted will also be visible here

  • Click on the tickbox next to the domain(s) you wish to remove from the allow-list

  • Select “Remove from allow-list” from the drop-down menu titled “Actions” and click “Go” to remove the domain(s)

Purging Existing Content

Moderators can add and remove domains at any time, and removing a domain from the allow-list will effectively block all future content from being received on your pod. Previously received messages and content from pods not on the allow-list will remain until you purge it from your pod. To do this:

  • Navigate to the “Moderation” menu. Any domains currently in the allow-list will be visible here with a green check mark next to their name. Other pods with which you have previously interacted will also be visible here

  • Click on the tickbox next to the domain(s) you wish to purge received messages from

  • Select “Purge” from the drop-down menu titled “Actions” and click “Go” to purge the messages