Test a new look for epics
DETAILS: Tier: Premium, Ultimate Offering: Self-managed Status: Experiment
- Introduced in GitLab 17.2 with several feature flags. Disabled by default. This feature is an experiment.
- Listing epics using the GraphQL API introduced in GitLab 17.4.
- Enabled on GitLab.com in GitLab 17.6.
FLAG: The availability of this feature is controlled by a feature flag. For more information, see the history. This feature is available for testing, but not ready for production use.
DISCLAIMER: This page contains information related to upcoming products, features, and functionality. It is important to note that the information presented is for informational purposes only. Please do not rely on this information for purchasing or planning purposes. The development, release, and timing of any products, features, or functionality may be subject to change or delay and remain at the sole discretion of GitLab Inc.
WARNING: This project is still in the experimental stage and could result in corruption or loss of production data. If you would like to enable this feature with no consequences, you are strongly advised to do so in a test environment.
We're working on changing how epics look by migrating them to a unified framework for work items to better meet the product needs of our Agile Planning offering.
For more information, see epic 9290 and the following blog posts:
- First look: The new Agile planning experience in GitLab (June 2024)
- Unveiling a new epic experience for improved Agile planning (July 2024)
Enable and disable the new look for epics
To try out this change on GitLab self-managed, run the following Rake task.
The task performs a database verification to ensure data consistency and might take a few minutes.
If the consistency check passes, the Rake task enables the work_item_epics feature flag.
If the check fails, the feature flag is not enabled. Inconsistencies are logged in the epic_work_item_sync.log file.
Failed background migrations or invalid imports can cause data inconsistencies. These inconsistencies will be resolved when work item epics become generally available.
To enable:
# omnibus-gitlab
sudo gitlab-rake gitlab:work_items:epics:enable
# installation from source
bundle exec rake gitlab:work_items:epics:enable RAILS_ENV=productionTo disable:
# omnibus-gitlab
sudo gitlab-rake gitlab:work_items:epics:disable
# installation from source
bundle exec rake gitlab:work_items:epics:disable RAILS_ENV=productionFeedback
If you run into any issues while trying out this change, you can use feedback issue to provide more details.