Element meta

element-meta is the shared home of the Element apps: Web and Desktop, Android and iOS. It holds what is common to all of them: feature requests, the processes the app teams follow, and product documentation.

Feature requests

This is the place to request a feature or a change for the Element apps, whatever the platform, calls included. Open an enhancement request.

The product team answers requests on the public Feature Requests Triage board. The answer also says whether we would accept a PR for it. It is not a roadmap: it says nothing about when anything ships. How feature requests are triaged explains what each answer means.

We no longer take feature requests in Discussions, and they will be closed. Please open an issue instead.

Where else to go

• A bug: the repository where it reproduces: element-web, element-x-android or element-x-ios, and element-call for calls.
• An SDK API, protocol, performance or crypto concern: matrix-rust-sdk for Element X on Android and iOS, matrix-js-sdk for Element Web and Desktop.
• The rich text composer: matrix-rich-text-editor, shared by all three apps.
• Signing in, signing up or managing your account in the web pages your homeserver opens for it: matrix-authentication-service.
• A security issue: email security@element.io, not a public issue. See the security disclosure policy.
• A question or support request: the app's Matrix room: #element-web:matrix.org, #element-x-android:matrix.org or #element-x-ios:matrix.org.

Contributing

A PR for a feature or an enhancement must reference an issue that carries the X-Accepting-PRs or X-Accepting-PoC-PRs label, with Part of element-hq/element-meta#N. Get agreement on the change before writing the code. Bug fixes don't go through product triage. Each app repository's CONTRIBUTING.md has the details for its codebase.

All contributions, AI-assisted or not, must follow CONTRIBUTING.md.

Process docs

• Contributing: what we expect from every contribution, AI-assisted or not.
• Feature requests: where to file them, how they are answered, when to write a PR.
• Label sync: the reusable workflow that syncs labels across repositories.

The app teams' other processes (issue triage, labelling, reviews) are being moved here from the wiki, which is out of date.

Product documentation

• docs/: how some Element features are meant to behave. Many of these pages date from 2022–2024, and some describe the legacy Element apps. Treat them as reference material, not as a description of the current apps.
• spec/: the non-standard Matrix event types used by Element.