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."
Resolution
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."
Resolution
Remove any Site.com 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."
Resolution
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 foundIn field: Network - no Network named XXX foundThe 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.