---
schema_version: "1"
id: e36187577247b6fab22e4fb0eeefa5145f5282d1ba21a195aeefce91af742b41
title: Troubleshoot Deployment Failures
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/troubleshoot_deployment_failures.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.troubleshoot_deployment_failures.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 73c6e08920a3345a33aaecca81a3f273638aaefd0366c17a08addeb3c1afbd6d
description: Review these common issues and learn how to fix them. If you need help, contact your Salesforce admin.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Troubleshoot Deployment Failures

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

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col style="width:100%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

**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.

#### See Also

- [_Salesforce Developers_: Let’s Talk Deployment (And Reasons Why They Succeed or Fail)](https://developer.salesforce.com/blogs/2018/06/lets-talk-deployment-and-reasons-why-they-succeed-or-fail)
- [_Salesforce Developers_: Deploy Metadata with Apex Testing Using REST](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_rest_deploy.htm)
- [Plan and Prepare for Deployment](https://help.salesforce.com/s/articleView?id=platform.plan_for_deployment.htm&release=264.0.0&type=5 "A successful deployment starts with a solid plan. To avoid conflicts or missing dependent metadata and configuration data during deployments, review these prerequisites, best practices, and limitations.")