Label Cleanup / Docs / Limits and troubleshooting

Limits and troubleshooting

Last updated 11/11/2026

Limits

Limit	Value
Work items per change job	50,000 (the preview says if more match - run the job again afterwards)
Labels per merge or delete	100
Labels listed on the page	20,000
Work items counted by a usage scan	200,000 (larger sites get partial counts, marked as partial)
Unconfirmed preview	Expires after 24 hours
Jobs at a time	One (a new preview replaces an unconfirmed one)
History kept	Last 50 jobs
Failures shown per job	50 (the total failed count is always shown)

Label names cannot contain spaces and can be at most 255 characters.

Message	What to do
You need the Administer Jira permission to use Label Cleanup.	Ask a Jira administrator to grant the permission or run the job for you.
Another job is still in progress	Wait for it to finish, or stop it from the panel at the top.
This preview is more than 24 hours old.	Run the preview again.
The new name is the same as the old one.	Pick a different new name (a different letter case counts as different).
Labels cannot contain spaces.	Use `-` or `_` instead of spaces.
Choose at least one label to merge into the target.	Add a label other than the one you keep.

Still stuck? Open a request in the Taskhooker support portal and include the app version shown at the bottom of the app page.