Troubleshooting
Self-serve troubleshooting. Need more help? Our in-app chat is here for any other questions.
By Jason and 34 others35 authors196 articles
- Troubleshooting slow comparison speeds
- A note on deploying custom object permissions on new profiles
- Are profile permissions showing up as "New" or "Deleted" when you know it's not the case?
- Can Gearset migrate the Email Message Relation object and its encryption setting?
- Are you getting "Invalid api version" when deploying Apex classes?
- Salesforce org error - "Error: duplicate value found: GearsetExternalID__c duplicates value on record with id: <xxx>"
- Changes to Flows in v44 of the metadata API
- Common causes of slow validations or deployments
- Common problems with viewing metadata in source control
- Gearset Cannot Retrieve Standard Tabs
- How to use the bisection method to debug retrieval errors?
- In git with org comparisons, why are the results different from org to org comparisons?
- How can I resolve the error "The resource data for the static resource ‘...’ appears to be missing, although the XML file is present..."?
- Metadata missing when committing to git branches
- Running tests synchronously in a test monitor
- Sharing your comparison with Gearset
- Which destructive changes does the metadata API not handle?
- Why can’t I find specific metadata in my Gearset comparison results?
- Why are my managed package metadata components not showing up?
- Why are there metadata differences in my freshly refreshed sandbox?
- Why can't I compare the standard matching rules?
- Why are there differences between my git branch and my org after initialization?
- Why can't I find my difference?
- Why can't I see any Apex classes in my comparison?
- Why has Gearset added components of 'No difference' to my deployment package?
- Is your Flow not showing up in the Flow Navigator mode in our comparison?
- Troubleshooting deployments made via Compare and deploy
- Why is the deployment summary item count different from the selected item count?
- Why are some of my letterhead items not showing up in the comparison?
- Why is XML order of some metadata in the comparison results different?
- Why can't I deploy "<ViewAllFields>" changes
- Why can't I deploy External Credential Principal mappings on the Profile metadata type?
- Flow appears as "New" when it exists in the target org
- How does Gearset handle requests that exceed the download limit?
- Resolving validation errors - "The translation for the '[flow]' flow references the [element], which isn't available in the flow"
- Resolving validation errors - "A Recipe must specify a Dataflow" on WaveRecipe metadata type
- Resolving validation errors - "An approval process can't be active until it has at least one approval step"
- Resolving validation errors - "Cannot change which global value set this picklist uses"
- Resolving validation errors - "Cannot find a user that matches any of the following usernames: <xxx>; remove the user from the component being deployed or create a matching user in the destination organization."
- Resolving validation errors - "Cannot modify managed object" on PermissionSet metadata type
- Resolving validation errors - "Cannot set sharingModel to ControlledByParent on a CustomObject without a MasterDetail relationship field"
- Resolving validation errors - "Cannot specify a gender for a gender neutral language"
- Resolving validation errors - "Cannot specify: inlineHelpText for platform event field"
- Resolving validation errors - "Cannot use field:WhatId in RelatedContent section." on Layout metadata type
- Resolving validation errors - "Component names can only contain alphanumeric characters, hyphens, colons, and underscores. Correct label in <xxx>.json and try again."
- Resolving validation errors - "Component [force:highlightsPanel] attribute [actionNames]: We couldn't validate Custom Action <xxx>" on FlexiPage metadata type
- Resolving validation errors - "ControlledByParent is not a valid sharing model for Asset" on Custom object metadata type
- Resolving validation errors - "Control field value <xxx> not found, valid values are <yyy>"
- Resolving validation errors - "Couldn't locate layout section: <xxx> in layout <yyy>"
- Resolving validation errors - "CustomApplication - You specified one or more duplicate ProfileActionOverride values."
- Resolving validation errors - "Custom metadata type "XXX_mdt" is not available in this organization"
- Resolving validation errors - "Duplicate label <xxx>" for deployment with Global Value Set metadata type
- Resolving validation errors - "Picklist value: <xxx> in picklist: <yyy> not found."
- Resolving validation errors - "Entity cannot be untracked." on various standard objects
- Resolving validation errors - "Entity is null or entity element's name is null"
- Resolving validation errors - "EntityObject can not be initialized with null EntityInfo"
- Resolving validation errors - "Error parsing file: Element {http://soap.sforce.com/2006/04/metadata}dayOfMonthToRun invalid at this location in type FlowSchedule" on Flows
- Resolving validation errors - "Error parsing file: ' ' is not a valid value for the enum 'Gender'"
- Resolving validation errors - “Failed to encode <xxx>, Error retrieving UiFormatSpecificationSet ID”
- Resolving validation errors - "Failure DestructiveChanges.xml"
- Resolving validation errors - "Fields in highlights panel must be a subset of fields in detail section" on Layout metadata type
- Resolving validation errors - "field integrity exception: unknown - (<xxx> Access level below organization default)"
- Resolving validation errors - "Field: field, value <xxx> appears more than once"
- Resolving validation errors - "Flow Action Error: The value in <actionName> is either missing or contains multiple fields" on Send Email actions
- Resolving validation errors – "In field: application - no CustomApplication named standard__SalesCloudMobile found"
- Resolving validation errors – "In field: application - no CustomApplication named standard__XXXX found"
- Resolving validation errors - "In field: excludeButtons, no such standard action:CreateSalesSummaries"
- Resolving validation errors - "In field: QuickAction - no QuickAction named <xxx> found"
- Resolving validation errors - "In field: field - no <metadata_type> named <xxx> found"
- Resolving validation errors - "In field: report - no Report named <xxx> found" on Dashboard metadata type
- Resolving validation errors - "insufficient access rights on cross-reference id: <xxx>"
- Resolving validation errors - "invalid cross reference id" for Custom application metadata
- Resolving validation errors - "Invalid data type" on Custom Address field
- Resolving validation errors - "Invalid element reference <xxx> not found for target"
- Resolving validation errors - "Invalid field name <xxx>" on Report metadata type
- Resolving validation errors - "Invalid field: SOLUTION.ISSUE in related list: RelatedSolutionList" on Layout metadata type
- Resolving validation errors - "Invalid field <xxx> in related list:RelatedAccountContactRelationList"
- Resolving validation errors - "Invalid property <xxx> in component <yyy>"
- Resolving validation errors - "Invalid condition logic: The filter logic references an undefined filter: <x>" on Flow metadata
- Resolving validation errors - "Invalid target dialog reference <xxx>"
- Resolving validation errors - "Invalid version number <x>" on FlowDefinition metadata type
- Resolving validation errors - "INVALID_TYPE: Cannot use: WorkflowRule in this organization"
- Resolving validation errors - LIMIT_EXCEEDED: Try deploying again. Your deployment exceeded its maximum retry limit"
- Resolving validation errors - "miniLayoutField: <field> is not present in the full layout" on Layout metadata
- Resolving validation errors - "Must Specify a Non-Empty Label for the Custom Object"
- Resolving validation errors - "Name (Screen Component) inputsOnNextNavToAssocScrn isn't supported for field Type "InputField""
- Resolving validation errors - "No more than 10 columns may be specified in lookupPhoneDialogsAdditionalFields"
- Resolving validation errors - "Not available for deploy for this API version" on GenAiPlanner metadata type
- Resolving validation errors - "Not available for deploy for this organization"
- Resolving validation errors - "One of the objects selected for your roll-up summary uses dated exchange rates and the other object does not. Roll-up summary fields can only summarize values of currency fields if both objects convert values (...)"
- Resolving validation errors - Once an approval process has been activated, you cannot add or remove steps. Please create a new approval process from this one for modification. You may only delete an approval process that has no data records associated..."
- Resolving validation errors - "Permission <xxx> depends on permission(s): <yyy>"
- Resolving validation errors - "QuickText is not a valid Tab" on Profile metadata type
- Resolving validation errors - "RecordType (Screen Component) - inputsOnNextNavToAssocScm isn't supported for fieldType <xxx>"
- Resolving validation errors - "SortOrder must be in sequential order from 1" on Duplicate Rule metadata type
- Resolving validation errors - "This custom field is referenced elsewhere in salesforce.com. : Flow Version - <version_number>"
- Resolving validation errors - "Test only deployment cannot update a field from a MasterDetail to Lookup"
- Resolving validation errors - "Test only deployment cannot update a field from a Lookup to MasterDetail"
- Resolving validation errors - "The approver null has an invalid type. Replace PreviousApprover with a valid enumeration value"
- Resolving validation errors - "The CustomObjectTranslation called <xxx> is standard and cannot be deleted"
- Resolving validation errors - "The field apiVersion can't be "<xxx>""
- Resolving validation errors - "The filter logic references an undefined filter" on FlexiPage metadata
- Resolving validation errors - "The sharing calculation you requested can't be processed right now...".
- Resolving validation errors - "There is already a Child Relationship named [RelationshipName] on [ObjectName" on CustomField metadata
- Resolving validation errors - "There is more than one instance identifier with the same name <xxx>"
- Resolving validation errors - "This profile is referenced elsewhere in Salesforce. Remove the usage and try again." on Profile metadata type
- Resolving UNKNOWN errors - "UNKNOWN_EXCEPTION: An unexpected error occurred. Please include this ErrorId if you contact support
- Resolving validation errors - "Unknown user permission: packaging2promoteversion" on Profile metadata
- Resolving validation errors - "Unsupported custom field type conversion attempted."
- Resolving validation errors - "Variable does not exist: <xxx>" on Apex class metadata
- Resolving validation errors - "We couldn't validate <property_name> in <file_path.json> for component <component_id>. Error:<specific_error_information>" on Experienced Bundle metadata type
- Resolving validation errors - "You can't delete this approval process because records were submitted for approval and haven't completed the process"
- Resolving validation errors - "You may not modify the permission <xxx> while editing a Standard Profile"
- Resolving validation errors - "<xxx (Action) We can't find an action with the name and action type that you specified." on Flow metadata type
- Resolving validation errors -"<xxx> (Action) - We can't find an action with the name and action type that you specified" on Flow deployment with GenAiPromptTemplate included
- Resolving validation errors - "<xxx> - "apexClass" is invalid. Provide the API name of an Apex class that includes an Apex data type supported in flows."
- Resolving validation errors - "<xxx> does not exist or is not a valid override for action <yyy>"
- Resolving validation errors - "<xxx> is not a valid condition field for : <yyy>" on Duplicate Rule metadata type
- Resolving validation errors - "<xxx> isn't a valid value for Conditional Formatting."
- Resolving validation errors - "You cannot deploy to a required field: <xxx>"
- Resolving validation errors - "You can't edit tab settings for <xxx>, as it's not a valid tab." - where <xxx> refers to a specific Custom Object
- Resolving common validation errors related to 'Experience Bundle' metadata type
- Resolving FlexiPage validation errors: unused Facet regions
- The value for urlPathPrefix in DigitalExperienceConfig isn't valid. Check the value and try again
- Resolving CustomApplication validation errors: workspace mapping tab is not defined
- Resolving validation errors - "NoDataFoundException / check_access_nc error deploying Agentforce metadata"
- Are your Pull Requests not showing what we expected?
- Why are my PRs showing the Pipeline owner?
- Why is my commit not being reflected in the promotion branches?
- Why am I hitting my repository API limit?
- Is the webhook set up for the CI job?
- Is the metadata included in the metadata filter?
- Have the problem analyzers stripped the metadata item out?
- Has the component made it into the deployment package zip file?
- Is the component you're deploying referenced in the .forceignore / .gitignore file?
- Is it the user permissions that aren't getting deployed to the org?
- Other error(s) you may be experiencing in your CI jobs
- Troubleshooting Pipelines and CI jobs
- Why did multiple PRs deploy when I've only selected one to promote?
- Incomplete permission report
- False permissions and CI jobs
- Issue with using AzureDevOps extension to resolve conflicts
- Troubleshooting error "UNABLE_TO_LOCK_ROW, unable to obtain exclusive access to this record" in Unit test jobs
- Deploying permissions through Delta CI
- How to confirm what is in a Gearset CI job deployment package?
- Unexpected changed records in data backup runs
- Unusually large amount of deleted records on a data backup job run
- Why are LastReferencedDate and LastViewedDate fields not backed up?
- Why aren't all files being backed up from my org?
- Why can't I restore [Object]History from my data backup?
- I see a message about some files were not backed up
- Resolving data deployment errors: missing related records
- Resolving data deployment errors: INACTIVE_OWNER_OR_USER
- Resolving data deployment errors: DUPLICATES_DETECTED
- Resolving data deployment errors: DUPLICATE_VALUE:duplicate value found
- Resolving data deployment errors: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
- Resolving data deployment errors: FIELD_CUSTOM_VALIDATION_EXCEPTION
- Resolving data deployment or CPQ error: "REQUIRED_FIELD_MISSING:Required fields are missing <xxx>"
- Resolving data deployment errors: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
- Resolving data deployment errors: DUPLICATE_VALUE & DUPLICATE_EXTERNAL_ID
- Resolving data deployment errors: INVALID_CROSS_REFERENCE_KEY: Record Type ID
- What information is useful when debugging data deployment issues?
- Understanding data deployment errors
- Campaign object does not show for selection when configuring a data deployment
- Why does Gearset exclude duplicate records during a data deployment?
- Resolving data deployment errors: unable to create/update fields
- Resolving "UNABLE_TO_LOCK_ROW: Unable to Obtain Exclusive Access to This Record" when deploying data
- Resolving "TooManyLockFailure" when deploying data
- Resolving data deployment errors: Assigning a permissions set to an inactive user
- How to deploy OrgWideEmailAddress and related access in PermissionSets
- Resolving data deployment issues: User lookup fields not populating
- Resolving issues with logging in and connecting orgs via Salesforce
- Common authentication and comparison errors
- How do I cancel a validation or deployment that has started?
- Why can't I see all of my scratch orgs?
- Troubleshooting Azure DevOps connection
- How to solve "unknown git error" when connecting to custom git repository
- Troubleshooting Salesforce login
- Authentication issues after a sandbox refresh
- Change source control and services connections in Gearset
- Deleting an Org Connection
- Does your GitHub connection give the error "Gearset can't find any repositories"?
- Salesforce login() flow retirement & External Client App migration
- How to replicate deployment errors with other tools?
- How to replicate deployment errors using Salesforce CLI
- How come Gearset doesn't show my item?
- How to replicate retrieval issues using Salesforce CLI
- How to replicate metadata download speeds with Workbench
- How to replicate metadata download speeds using Salesforce CLI