Skip to main content


I finally figured out how to add my matrix rooms to the matrix.org server's room dir for greater discoverability. It's not a great workflow, but here's how to do that safely, if you are on a different homeserver:

1. You'll need a matrix.org account, a throwaway one will do it.
2. Join the room you want to add with that account
3. Set the m.room.canonical_alias permission to custom level 10
4. grant your matrix.org user that custom level
1/2
This also works for every other matrix server with a public room dir of course.
I.e. I also added it to the shivering-isles.com server's room directory.

@sheogorath also has an article about matrix room directories in general and how to add other's server room dirs to your client: https://shivering-isles.com/Using-the-matrix-room-directory
Where can I see the mentioned Permission? In Element I only see something like Change Room Name.
I have given the user Mod right for that and afterwards removed the permission again. Thanks for the hint, thoug.
uhm if that is so complicated, would not make sense for to document that somewhere?
some Matrix wiki oder so? I guess there has to be sth.
are matrix developers her eon Mastodn to know where tp put this? Ma
ybe they can help… @khaos
I don't know where the "right" place to put it is, but you can throw the information in a GitHub issue and let someone else try to figure it out. IIRC, you don't *need* the m.room.canonical_alias permission, but we also don't (yet) have a proper reliable way of determining whether you're allowed to publish to publish to the room directory.