Error overview
You may run into this Salesforce validation error when deploying Layout metadata in Gearset.
An example of the error message would be as below:
"Invalid field:SOLUTION.ISSUE in related list:RelatedSolutionList"
Explanation of the error
Based on Salesforce documentation (April 2025), this is a known issue.
Your validation against the Sandbox org would fail when the deployment package contains Case Page Layout, and the page layout contains "RelatedSolutionList".
Salesforce explains this error is only seen on a Sandbox validation, and is intermittent.
Therefore, we understand this error may happen occasionally and not necessarily during every single validation of the affected metadata component.
Resolution
Salesforce recommends removing the <relatedlist> for RelatedSolutionList from the Case Page Layout.
This should help with validation succeeding and your deployment going through.
What needs to be removed from the source environment s the following XML from the Case Page Layout
<fields>SOLUTION.ISSUE</fields>
<fields>SOLUTION.SOLUTION_NUMBER</fields>
<fields>SOLUTION.STATUS</fields>
<fields>CORE.USERS.ALIAS</fields>
<relatedList>RelatedSolutionList</relatedList>
Example of the XML from Gearset's comparison results:
Resolution for a PR failing the validation in Gearset Pipelines
If you've come across this error during PR (pull request) validation in your Pipelines, follow these steps.
Workaround 1
Commit the deletion of the required lines of code to your feature branch from which the PR was originally created.
Is the PR opened against the first environment in your Pipeline? Follow the guidelines described in point 1 of this article: Edit or fix a user story in progress in pipelines.
Was the PR propagated to more than one environment in your Pipeline? Follow the guidelines described in point 2 of the above article.
Workaround 2
Alternatively, you can make the change directly in the feature branch in your Git repository (in the Version Control System) where you'd delete these lines of code from the XML.
Once they're deleted, re-validate the PR in your Pipelines. This should hopefully make your validation succeed, and allow you to merge the PR.
Resolution for org to org deployments
If you're using our Compare and deploy feature, e.g. for org to org deployment, follow these steps:
After you've run the comparison that failed the validation, download the deployment package (.zip) created in Gearset.
Make the change locally in the affected file by removing the required lines of code from the XML.
Once the XML file of the Case Page Layout is amended, re-run the comparison in Gearset using the "Local files" option as the source of your deployment on Compare and deploy page.
Select the amended deployment package (.zip), and validate it against the target org.
Guidelines on how to download and amend the deployment package:
How can I change the deployment package before deploying?
Useful resources
More information on this error in Salesforce Known Issues page.
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.