Skip to main content
All CollectionsTroubleshootingSalesforce validation errorsSalesforce validation errors
Resolving common validation errors related to 'Experience Bundle' metadata type
Resolving common validation errors related to 'Experience Bundle' metadata type

Guidance on causes and solutions to commonly seen validation errors related to ExperienceBundle metadata type

Jacob Joshua avatar
Written by Jacob Joshua
Updated over a week ago

Validation Error - "XXX wasn’t deployed because ExperienceBundle isn’t enabled for Aura sites. To enable ExperienceBundle, in Setup, select Enable ExperienceBundle Metadata API in Digital Experiences | Settings."


Go to both source and target Orgs and check the Enable ExperienceBundle Metadata API checkbox.

Validation Error - "The value for urlPathPrefix in ExperienceBundle isn't valid. Check the value and try again."


Remove any metadata from the deployment package.

Validation Error - "The reportId property of component <xxx> references an object with the ID value <yyy>.
Occasionally, when deployed to a destination org, ID values can become invalid—for example, if the referenced ID doesn’t exist in the destination org. If you encounter component issues in your destination org, verify that the ID values are correct."


Disable the Treat warnings as errors deployment setting on your account page.

Other errors we have seen during deployments:

Note: These were only seen when attempting to deploy components which the XML had been modified directly before deployment

  • In field: Site - no CustomSite named XXX found

  • In field: Network - no Network named XXX found

  • The Default Web Address must be alphanumeric.

These errors occurred when an edit was made directly to the .xml of the Custom site and Network metadata, specifically a /s was added in onto the urlPathPrefix.

To resolve these errors remove /s (or any such extras) from the field urlPathPrefix in CustomSite and Network.

To see how to edit the deployment package see this article.

Error related to 'currentThemeID' property in a .json file

The error message we're referring to is as below:

The currentThemeId property in <xxx>.json is null or points to a non-theme component. Update currentThemeId to point to the site's theme and try again

We found that the currentThemeId could be different from Org to Org and the mismatch could result in this error.

You can try to edit that value in your deployment package to match the target Org to see if it works. Or temporarily use Environment variable functionality to match the source value's ID.

Disclaimer: This error is returned by Salesforce directly, rather than Gearset. Even so, we offer guidance based on our combined experience with the Metadata API. Where possible, we try to help guide you to fix or avoid this error. In the case that this isn't possible, we may need to direct you to Salesforce support for further clarification.

Did this answer your question?