You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/docs/reference/change-requests.mdx
+23-4
Original file line number
Diff line number
Diff line change
@@ -13,10 +13,10 @@ import VideoContent from '@site/src/components/VideoContent.jsx';
13
13
## Overview
14
14
15
15
Change requests allow you to require an additional approval step before any changes can be made in an environment. This functionality supports the "four-eyes principle", ensuring compliance in industries with strict legal or regulatory requirements.
16
-
16
+
17
17
Change requests also allow you to group changes and [apply them at a specific point in time](#scheduled-change-requests).
18
18
19
-
Change requests can be enabled on a per-project and per-environment basis. This allows you to differentiate your configurations across different environments, such as production and development.
19
+
Change requests can be enabled for a specific environment within a project, or configured globally for an environment across all projects. This allows you to differentiate your configurations across different environments, such as production and development.
20
20
21
21
You can require up to 10 approvals for a change request.
22
22
@@ -78,7 +78,7 @@ Alternatively, you can use constraints or segments with the `DATE_AFTER` [operat
78
78
### Scheduling errors
79
79
80
80
Unleash suspends a scheduled change request if:
81
-
- The change request includes updates to a flag that has been archived or a strategy that has been deleted.
81
+
- The change request includes updates to a flag that has been archived or a strategy that has been deleted.
82
82
- The change request includes a strategy, segment, or variant that has been updated.
83
83
- The user who scheduled a change request is deleted from the users list before the scheduled time.
84
84
@@ -104,8 +104,27 @@ While change requests are environment-specific, project segments are not. For th
104
104
105
105
Only Admin users can bypass the change request process for project segments through API calls.
You can preconfigure change request requirements at the environment level. When configured, all new projects automatically inherit these approval requirements for the specified environments.
116
+
117
+
You can use environment-level change requests in two ways:
118
+
119
+
***As defaults**: Set default approvals per environment, but allow project [Owners](/reference/rbac#projects#predefined-roles) and users with [project update permissions](/reference/rbac#projects) to override the defaults within their projects.
120
+
***As enforced requirements**: Set mandatory approvals for a given environment across all projects. To fully enforce this in a project, ensure that the project has no Owner or users with project update permissions—this prevents any change request modifications at the project level.
121
+
122
+
You can predefine environment-level change requests when creating or editing an environment in **Configure > Environments**.
To verify a change request, you can preview the changes in [Playground](/reference/playground) by clicking **Preview changes**. You can adjust [Unleash context](/reference/playground#the-unleash-context), but the project and environment remain fixed as they are determined by the change request.
110
129
111
-
You can only preview a change request in **In Review**, **Approved**, or **Scheduled** states.
130
+
You can only preview a change request in **In Review**, **Approved**, or **Scheduled** states.
0 commit comments