Skip to content

Spec for MSC3784: Using room type of m.policy for policy rooms #2411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
turt2live merged 5 commits into from
Aug 11, 2026
Merged

Spec for MSC3784: Using room type of m.policy for policy rooms #2411

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
94dd59b
Spec for MSC3784: Using room type of m.policy for policy rooms
thetayloredman Jul 12, 2026
89cc8a7
Specify behavior of the m.policy room type, fix changelog
thetayloredman Jul 14, 2026
b41698a
Remove line wrapping from changelog
thetayloredman Jul 14, 2026
1320865
Update wording of the section to match MSC
thetayloredman Aug 11, 2026
b42c718
Add spec version marking for added sections
thetayloredman Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions changelogs/client_server/newsfragments/2411.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Introduce room type `m.policy` to indicate rooms likely to contain policy lists, as per [MSC3784](https://github.com/matrix-org/matrix-spec-proposals/pull/3784).
1 change: 1 addition & 0 deletions content/client-server-api/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3818,6 +3818,7 @@ the create room request.
In this specification the following room types are specified:

* [`m.space`](#spaces)
* [`m.policy`](#moderation-policy-lists) {{% added-in v="1.20" %}}

Unspecified room types are permitted through the use of
[Namespaced Identifiers](/appendices/#common-namespaced-identifier-grammar).
Expand Down
11 changes: 11 additions & 0 deletions content/client-server-api/modules/moderation_policies.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,17 @@ restrictions on how the rooms can be configured in terms of
[join rules](#mroomjoin_rules), [history visibility](#room-history-visibility),
encryption, etc.

{{% added-in v="1.20" %}}
Dedicated moderation policy rooms SHOULD use the [`m.policy` room type](#types).
Comment thread
thetayloredman marked this conversation as resolved.
However, use of the room type is not required. Policy events MAY be sent in any
room.

Like [spaces](#spaces), sending normal [`m.room.message`](#mroommessage) events
within a policy room is discouraged. Policy rooms should be created with
[`m.room.power_levels`](#mroompower_levels) which prohibit normal events by
setting `events_default` to a suitably high number. In the default power level
structure, this would be `100`.

There are currently 3 kinds of entities which can be affected by rules:
`user`, `server`, and `room`. All 3 are described with
`m.policy.rule.<kind>` state events. The `state_key` for a policy rule
Expand Down
Loading