matrix-org/matrix-spec

View on GitHub

The Matrix protocol specification

Stars: 330
Forks: 150
Open beginner issues: 5
Indexed issues: 1.1k
Avg merge: 2h 21m
Merged PRs (30d): 3

Dominant language: HTML
License: Apache-2.0
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

1,079 open issues indexed

Switch toward time-based fallback key rotation Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 45/100

matrix-org/matrix-spec#2445 · 1 comment · Opened Sep 17, 2026
`/room_summary` has the wrong default for `join_rule` being omitted Open

improvement

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

matrix-org/matrix-spec#2444 · Opened Sep 15, 2026
Handling of m.mentions and notifications.room in m.room.power_levels not explicit Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

matrix-org/matrix-spec#2443 · 2 comments · 1 reaction · Opened Sep 14, 2026
Spec doesn't explicitly forbid changing the ed25519 signing key of a device Open

A-E2EE clarification spec-omission

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

matrix-org/matrix-spec#2442 · Opened Sep 12, 2026
Include SAS emoji translations in spec release documentation Open

release-blocker

matrix-org/matrix-spec#2439 · 1 assignee · Opened Sep 8, 2026
Spec's `NACL` allusions are ambiguous to ZIP-215 vs. strict RFC 8032 `ed25519` signing key algos Open

clarification

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2437 · Opened Aug 26, 2026
Missing example for m.key.verification.start$m.reciprocate.v1 Open

clarification

Difficulty 1/5 Under an hour Newbie friendliness 88/100

matrix-org/matrix-spec#2436 · Opened Aug 25, 2026
State resolution when one (or more) `prev_events` is unknown, unresolvable, or external Open

clarification

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2434 · Opened Aug 11, 2026
Add necessity to check MSCs for clear requirement levels to checklist Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

matrix-org/matrix-spec#2431 · 4 comments · Opened Aug 5, 2026
Spec requires support for exponential notation in JSON Open

spec-bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

matrix-org/matrix-spec#2424 · Opened Jul 21, 2026
`X-Matrix` authentication header makes request buffering necessary, but it doesn't actually need to depend on the request content Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2423 · 2 reactions · Opened Jul 20, 2026
Store spec implementation guides in an appendix of the spec Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

matrix-org/matrix-spec#2420 · Opened Jul 15, 2026
Clarify how to handle key sharing wrt history visibility for invites Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 55/100

matrix-org/matrix-spec#2419 · 1 comment · Opened Jul 15, 2026
Rejoinability of (empty) rooms the local server has left is not well-defined Open

clarification

Difficulty 4/5 3-5 days Newbie friendliness 38/100

matrix-org/matrix-spec#2415 · 1 comment · Opened Jul 13, 2026
Inconsistency of `m.room.power_levels` definition with room verion 12 (MSC4289) Open

spec-bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

matrix-org/matrix-spec#2409 · 1 comment · Opened Jul 10, 2026
Add a checklist to the security considerations template? Open

Difficulty 3/5 1-2 days Newbie friendliness 58/100

matrix-org/matrix-spec#2405 · Opened Jul 1, 2026
Room summary API is missing authentication options Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

matrix-org/matrix-spec#2393 · Opened Jun 8, 2026
Auth rules for PL events don't say if the default value counts as "present" or not Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 55/100

matrix-org/matrix-spec#2388 · 2 comments · Opened Jun 2, 2026
MSC4186 Sliding Sync seems to be missing high-level stewardship on pagination strategies Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2378 · 1 comment · Opened May 13, 2026
UserID type not used consistently Open

clarification

Difficulty 4/5 3-5 days Newbie friendliness 55/100

matrix-org/matrix-spec#2365 · 2 comments · Opened Apr 28, 2026
Grammar for account data types Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

matrix-org/matrix-spec#2356 · 1 comment · Opened Apr 16, 2026
Grammar for Secret Storage key ID Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

matrix-org/matrix-spec#2355 · 1 comment · Opened Apr 16, 2026
Include heroes for invites/knocks to be able to display a room name Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2353 · Opened Apr 8, 2026
Missing spec for `org.matrix.preview_urls` account data Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

matrix-org/matrix-spec#2350 · 1 comment · Opened Mar 31, 2026
Define "mimetypes" Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

matrix-org/matrix-spec#2342 · 5 comments · Opened Mar 23, 2026
CSAPI `GET /rooms/{roomId}/event/{eventId}` does not pull events over federation, breaking pinned messages (it's not clear how clients should fetch `m.room.pinned_events`) Open

clarification

Difficulty 5/5 Over a week Newbie friendliness 25/100

matrix-org/matrix-spec#2335 · 3 comments · Opened Mar 11, 2026
/_matrix/client/v1/media/preview_url should clarify what status codes / errors may be returned Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 38/100

matrix-org/matrix-spec#2327 · Opened Mar 3, 2026
Navigation header should be sticky in mobile view Open

aesthetic

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

matrix-org/matrix-spec#2325 · 1 comment · Opened Feb 28, 2026
Option to "sync" room power levels and permissions with the parent space Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2322 · 3 comments · Opened Feb 25, 2026
Forum type rooms Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 30/100

matrix-org/matrix-spec#2321 · 1 comment · Opened Feb 23, 2026
Underscores in string powerlevels Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 35/100

matrix-org/matrix-spec#2314 · 1 comment · Opened Feb 16, 2026
How to check if guest registration is available, without creating a guest account? Open

clarification

Difficulty 5/5 Over a week Newbie friendliness 35/100

matrix-org/matrix-spec#2313 · 1 comment · Opened Feb 15, 2026
/media/v3/preview_url response spec should include the original value of og:image Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

matrix-org/matrix-spec#2312 · Opened Feb 14, 2026
Cascading Bans and Kicks for subspaces Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 25/100

matrix-org/matrix-spec#2310 · 3 comments · Opened Feb 7, 2026
Follow threads to minimise notification spam Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 25/100

matrix-org/matrix-spec#2309 · 3 comments · Opened Feb 7, 2026
No existing server implementations follow the spec for `GET /_matrix/client/v3/rooms/{roomId}/members` query parameters Open

spec-bug

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

matrix-org/matrix-spec#2308 · 1 comment · Opened Feb 4, 2026
Immutable encryption and history visibility Open

improvement

Difficulty 5/5 Over a week Newbie friendliness 25/100

matrix-org/matrix-spec#2302 · 3 reactions · Opened Jan 27, 2026
How to handle event edits when excluding insecure devices Open

clarification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

matrix-org/matrix-spec#2295 · 1 comment · Opened Jan 23, 2026
What does ignoring an invalid edit actually mean Open

clarification

Difficulty 3/5 1-2 days Newbie friendliness 35/100

matrix-org/matrix-spec#2294 · 6 comments · Opened Jan 23, 2026
In space events, is the `via` required or optional? Open

clarification good first issue

Difficulty 3/5 1-2 days Newbie friendliness 35/100

matrix-org/matrix-spec#2293 · 7 comments · Opened Jan 22, 2026
Table backgrounds dont span full width anymore Open

aesthetic

Difficulty 3/5 1-2 days Newbie friendliness 35/100

matrix-org/matrix-spec#2286 · 1 comment · Opened Dec 28, 2025
Do not rely on Element resources for spec development Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

matrix-org/matrix-spec#2281 · 6 comments · Opened Dec 19, 2025
Consider handling bridge bots in room names differently Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

matrix-org/matrix-spec#2279 · 1 comment · 1 reaction · Opened Dec 19, 2025
npm package for v1.17 failed to build Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

matrix-org/matrix-spec#2274 · 2 comments · Opened Dec 18, 2025
`POST /_matrix/client/v3/rooms/{roomId}/forget` fails to define a request body Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

matrix-org/matrix-spec#2271 · Opened Dec 16, 2025
`/register` takes undocumented `type` parameter Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 50/100

matrix-org/matrix-spec#2269 · Opened Dec 16, 2025
`GET /_matrix/client/v3/profile/...` states it do not require auth, but implementations can require auth Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

matrix-org/matrix-spec#2254 · 3 comments · Opened Nov 26, 2025
"MSC4289: Explicitly privilege room creators" did not specify what a creator's power level should be upon room downgrade Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

matrix-org/matrix-spec#2253 · 4 comments · Opened Nov 26, 2025
Clarify that you can't expect the redaction of a state event to remove its effect. Open

clarification

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

matrix-org/matrix-spec#2252 · 2 comments · Opened Nov 24, 2025
Missing device_one_time_keys_count should not imply zero Open

wart

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

matrix-org/matrix-spec#2251 · 2 comments · Opened Nov 24, 2025

matrix-org/matrix-spec

Get new issues in your inbox