Change history
Read time: 6 minutes
Last edited: May 06, 2024
For information on the audit log, read Audit log and resource history.
Overview
This topic explains how to track changes made in LaunchDarkly. LaunchDarkly keeps a running log of changes made to feature flags and other resources in each environment.
View the change history
The unlimited change history is available to customers on a Pro or Enterprise plan. For Starter plans, the change history is restricted to the last 30 days of events. To learn more, read about our pricing. To upgrade your plan, contact Sales.
The change history is a running tally of changes made to feature flags or other resources in a given environment.
To access the change history, click the clock icon from any page:
The "Change history" dialog appears. It is automatically filtered based on the page from which you clicked the clock icon. For example, if you click the clock icon from the flags list, the change history is filtered to show changes for flags in your current project, in the environments that you have selected on the flags list:
Filter the change history
To filter the change history, use the "Filter by resource" section.
You can use the "Filter by resource" section to filter the results by any of the following resources:
- Account
- Application
- Code reference
- Context kind
- Experiment
- Flag
- Integration
- Member
- Metric
- Project
- Relay Proxy
- Release pipeline
- Role
- Segment
- Service token
- Team
- Webhook
You can also filter for changes in particular projects, environments, and actions.
Click the link button in the "Filter by resource" section to copy a link to the current change history filter. You can share this with other members in your organization.
Actions recorded in the change history
In the LaunchDarkly UI, the change history displays a description of each action or set of actions, as entered by the member who performed them. If you use the REST API to review the change history, the API response also includes a list of the specific actions.
The following sections describe the actions that the change history records.
Expand for actions related to targeting changes
The following table includes the actions related to targeting changes that are recorded in the change history. Unless otherwise specified, these actions affect only the current environment:
| Action on flag | Name in REST response | Description |
|---|---|---|
| Update fallthrough | updateFallthrough | Update the default rule, also called the "fallthrough" rule. |
| Update flag variations | updateFlagVariations | Change the flag's variations. This action affects all environments in a project. |
| Update release workflows | updateFeatureWorkflows | Change a flag's release management workflows. |
| Update global archived | updateGlobalArchived | Change whether a flag is archived. This action affects all environments in a project. |
| Update off variation | updateOffVariation | Update the variation returned when the flag is toggled off. |
| Update on | updateOn | Toggle a flag's targeting on or off. |
| Update prerequisites | updatePrerequisites | Update flag prerequisites. |
| Update rules | updateRules | Update custom targeting rules. |
| Update scheduled changes | updateScheduledChanges | Change the scheduled updates on a feature flag. |
| Update targets | updateTargets | Update individual context targeting rules. |
Expand for actions related to flag settings
The following table includes the actions related to flag settings that are recorded in the change history. Each of these actions affect all environments in a project:
| Action on flag | Name in REST response | Description |
|---|---|---|
| Create flag | createFlag | Create a flag. |
| Delete flag | deleteFlag | Delete a flag. |
| Update client-side flag availability | updateClientSideFlagAvailability | Change whether the flag is available to client-side SDKs. |
| Update description | updateDescription | Change the description of a flag. |
| Update flag custom properties | updateFlagCustomProperties | Update custom properties attached to a flag. |
| Update flag default variations | updateFlagDefaultVariations | Change the default flag variations used by newly-created environments for a flag. |
| Update include in snippet | updateIncludeInSnippet | Change whether the feature flag is available to front-end code with the JavaScript SDK. |
| Update name | updateName | Rename a flag. |
| Update tags | updateTags | Update tags associated with a flag. |
| Update temporary | updateTemporary | Mark a flag temporary or permanent. |
Expand for actions related to environment-specific settings
The following table includes the actions related to environment-specific settings that are recorded in the change history:
| Action on flag | Name in REST response | Description |
|---|---|---|
| Create triggers | createTriggers | Create a new trigger. |
| Delete triggers | deleteTriggers | Delete a trigger. |
| Update flag salt | updateFlagSalt | Update a flag's salt. |
| Update track events | updateTrackEvents | Change whether to send detailed event information for a flag in a given environment. |
| Update triggers | updateTriggers | Update an existing trigger. |
Expand for actions related to collaboration
The following table includes the actions related to collaboration that are recorded in the change history:
| Action on flag | Name in REST response | Description |
|---|---|---|
| Apply approval request | applyApprovalRequest | Apply an approved approval request for a flag. |
| Bypass required approval | bypassRequiredApproval | Bypass required approvals in the environment. |
| Create approval request | createApprovalRequest | Create an approval request for a flag. |
| Create flag link | createFlagLink | Create a flag link. This affects all environments in a project. |
| Delete approval request | deleteApprovalRequest | Delete an approval request for a flag. |
| Delete flag link | deleteFlagLink | Delete a flag link. This affects all environments in a project. |
| Manage flag followers | manageFlagFollowers | Manage the list of members who receive flag change notifications. |
| Review approval request | reviewApprovalRequest | Review an approval request for a flag. |
| Update maintainer | updateMaintainer | Update the flag maintainer. This affects all environments in a project. |
| Update flag link | updateFlagLink | Update a flag link. This affects all environments in a project. |
Expand for actions related to other flag changes
The following table includes the actions related to other flag changes that are recorded in the change history:
| Action on flag | Name in REST response | Description |
|---|---|---|
| Clone flag | cloneFlag | Create a new flag with settings based on an existing flag. This affects all environments in a project. |
| Copy flag config from | copyFlagConfigFrom | Copy settings from a flag. |
| Copy flag config to | copyFlagConfigTo | Copy settings to a flag. |
| Update expiring targets | updateExpiringTargets | Change a flag's expiring individual context targeting rules. |
| Update flag rule description | updateFlagRuleDescription | Update the description for custom targeting rules. |