Troubleshoot Deployment Failures

Review these common issues and learn how to fix them. If you need help, contact your Salesforce admin.

Required Editions

Available in: Lightning Experience
Available in: Professional, Enterprise, Performance, Unlimited, and Developer Editions

Issue: A metadata component, such as a custom field, exists in the source org but is missing in the target org.

Action: Identify the missing metadata component and create it in the target org before redeploying.

Issue: The target org is missing related records.

Action: Migrate the missing parent or related records first. Use external IDs to make sure that relationships are maintained correctly.

Issue: You don’t have the necessary permissions in the target org.

Action: Verify that you have the required object and field-level permissions. If not, reauthenticate with the correct credentials or ask your Salesforce admin for the required access.

Issue: The connection to the target org was interrupted during the deployment.

Action: Check your network connection and firewall settings. Confirm that your credentials for the target org are still valid.