Featured communities allow you to highlight specific Matrix spaces, rooms, and servers in the Sable explore/discovery interface. This helps users find relevant communities quickly.
Configuration Structure
The featuredCommunities object in config.json controls all featured community settings:
{
"featuredCommunities": {
"openAsDefault": false,
"spaces": [],
"rooms": [],
"servers": []
}
}
Open as Default
Controls whether the featured communities panel opens automatically when users launch Sable.
Example
{
"featuredCommunities": {
"openAsDefault": true
}
}
true to show featured communities immediately on app load, helping users discover content right away.
Featured Spaces
Array of Matrix space aliases to feature. Spaces are collections of rooms organized around a theme or community.
#alias:homeserver.domain:
{
"featuredCommunities": {
"spaces": [
"#sable:sable.moe",
"#community:matrix.org",
"#space:unredacted.org",
"#science-space:matrix.org",
"#libregaming-games:tchncs.de",
"#mathematics-on:matrix.org"
]
}
}
Adding Your Own Spaces
- Find the space alias (starts with
#)
- Include the homeserver domain after the colon
- Add to the array:
{
"spaces": [
"#your-community:your-homeserver.com",
"#another-space:matrix.org"
]
}
Featured Rooms
Array of Matrix room aliases to feature. These are individual chat rooms or channels.
#alias:homeserver.domain:
{
"featuredCommunities": {
"rooms": [
"#announcements:sable.moe",
"#freesoftware:matrix.org",
"#pcapdroid:matrix.org",
"#gentoo:matrix.org",
"#PrivSec.dev:arcticfoxes.net",
"#disroot:aria-net.org"
]
}
}
Use Cases
- Highlight important announcement rooms
- Feature popular discussion channels
- Promote community support rooms
- Showcase topic-specific channels
Featured Servers
Array of homeserver domains to feature for server discovery. Users can explore public rooms on these servers.
{
"featuredCommunities": {
"servers": ["matrix.org", "mozilla.org", "unredacted.org"]
}
}
Adding Servers
{
"servers": [
"matrix.org",
"your-homeserver.com",
"community-server.org"
]
}
Complete Example
Here’s a full featured communities configuration from the default Sable config:
{
"featuredCommunities": {
"openAsDefault": false,
"spaces": [
"#sable:sable.moe",
"#community:matrix.org",
"#space:unredacted.org",
"#science-space:matrix.org",
"#libregaming-games:tchncs.de",
"#mathematics-on:matrix.org"
],
"rooms": [
"#announcements:sable.moe",
"#freesoftware:matrix.org",
"#pcapdroid:matrix.org",
"#gentoo:matrix.org",
"#PrivSec.dev:arcticfoxes.net",
"#disroot:aria-net.org"
],
"servers": ["matrix.org", "mozilla.org", "unredacted.org"]
}
}
Customization Examples
Corporate Deployment
Feature only your organization’s spaces and rooms:
{
"featuredCommunities": {
"openAsDefault": true,
"spaces": [
"#company-wide:company.com",
"#engineering:company.com",
"#marketing:company.com"
],
"rooms": [
"#announcements:company.com",
"#general:company.com",
"#support:company.com"
],
"servers": ["company.com"]
}
}
{
"featuredCommunities": {
"openAsDefault": false,
"spaces": [
"#opensource:matrix.org",
"#linux:libera.chat",
"#programming:mozilla.org"
],
"rooms": [
"#python:matrix.org",
"#javascript:matrix.org",
"#rust:mozilla.org"
],
"servers": ["matrix.org", "mozilla.org"]
}
}
Minimal Configuration
No featured communities:
{
"featuredCommunities": {
"openAsDefault": false,
"spaces": [],
"rooms": [],
"servers": []
}
}