Unclear error messages during Package Import

[MikeKry]

When an exception occurs during Package Import, the following scenarios are typically the cause:

• Conflict in Alias
• Conflict in Permalink

Current Error Messages

1. Permalink Conflict

Error importing content item version id 'XYZ': 'Your permalink is already in use.'

Problem: This error message only displays the content item version ID from the source environment. Since you cannot search by content item version in CMS, troubleshooting is difficult.

Suggested improvement: Include the following information:

• ContentItemId from both source and target environments
• Display text from both source and target
• Permalink from both source and target

2. Alias Conflict

Error importing content item version id 'XYZ': 'Your alias is already in use. "ALIAS"'

Current status: This message is better as it includes the alias name, but ContentItemId would still be useful for troubleshooting.

Current Workaround

The only way to troubleshoot these errors is to manually search for the version ID in:

• The ZIP package file, or
• The database (when remote deployment is active)

This process is time-consuming and could be avoided with more informative error messages.

Bonus

We could show these messages directly in the package import screen.

[Piedone]

Are these errors only logged currently, not shown when the import errors out?

[github-actions]

We triaged this issue and set the milestone according to the priority we think is appropriate (see the docs on how we triage and prioritize issues).

This indicates when the core team may start working on it. However, if you'd like to contribute, we'd warmly welcome you to do that anytime. See our guide on contributions here.