Skip to content

Test a new look for epics

DETAILS: Tier: Premium, Ultimate Offering: Self-managed Status: Experiment

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:

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=production

To disable:

# omnibus-gitlab
sudo gitlab-rake gitlab:work_items:epics:disable

# installation from source
bundle exec rake gitlab:work_items:epics:disable RAILS_ENV=production

Feedback

If you run into any issues while trying out this change, you can use feedback issue to provide more details.

Related topics