Update beta documentation (#32757)

* Add missing feature_notification_settings2

* Update beta docs with stronger restrictions

* a note

* Update betas.md

* Update betas.md
This commit is contained in:
Will Hunt
2026-03-16 09:53:34 +00:00
committed by GitHub
parent d791e3fe8a
commit b54e4e3b98
2 changed files with 42 additions and 8 deletions
+34 -7
View File
@@ -1,14 +1,41 @@
# Beta features
# Beta Features
Beta features are features that are not ready for production yet but the team
wants more people to try the features and give feedback on them.
A feature is marked as beta when it is nearly ready for production and the
team would like to gather wider feedback before turning it on by default.
Before a feature gets into its beta phase, it is often a labs feature (see
[Labs](https://github.com/element-hq/element-web/blob/develop/docs/labs.md)).
Betas are visible to all users, [**including** users who have disabled labs settings
tab](./config.md)
**Be warned! Beta features may not be completely finalised or stable!**
**Be warned! Beta features are not considered stable and should not be relied upon!**
## Video rooms (`feature_video_rooms`)
## Requirements
A beta feature MUST first become a labs feature before it can become a beta (see
[Labs](./labs.md)).
A beta feature MUST have an expected timeline to be upgraded to a stable feature. This timeline
should not exceed 3 months. If a feature persists in beta for longer and hasn't been explicitly
extended, the feature MAY be backed out to labs.
A beta feature SHOULD have a rollback path for users to opt-out. If a feature is irreversible or
could corrupt a user's session or account, it should not be in beta. If this is not possible, it
MUST be discussed with the team first to devise an alternative strategy.
A beta feature SHOULD have analytics so that the team can understand how many users
are using it.
## Current Betas
This is the current set of betas enabled in Element Web.
### Video rooms (`feature_video_rooms`)
Enables support for creating and joining video rooms, which are persistent video
chats that users can jump in and out of.
### New notifications settings (`feature_notification_settings2`) [Beta]
Replaces the legacy notification settings with a new one to manage push rules.
**Warning** This feature has options which are not backwards compatible, disabling
it may have unintended consequences.