Troubleshooting

Resolving common issues with comparisons and deployments

Kevin Boyle avatar Jason Mann avatar Luke avatar +14
54 articles in this collection
Written by Kevin Boyle, Jason Mann, Luke and 14 others
Comparisons and deployments

Why is my metadata deployed to source control in SFDX or MDAPI format?

How to ensure that your metadata is deployed in the correct format
Nicole Bazarova avatar
Written by Nicole Bazarova
Updated this week

Which destructive changes does the metadata API not handle?

Valerio avatar
Written by Valerio
Updated over a week ago

Why can’t I find specific metadata in my Gearset comparison results?

Explanations for why a metadata item may be missing, and tips to fix this
Carly Hammond avatar
Written by Carly Hammond
Updated over a week ago

Gearset cannot retrieve standard tabs

And how Gearset can retrieve standard tab visibilities
Valerio avatar
Written by Valerio
Updated over a week ago

Why are my managed package subcomponents showing up inconsistently?

Searching for managed package metadata
Valerio avatar
Written by Valerio
Updated over a week ago

Why can't I find my difference?

I know there's a difference between my orgs, but I can't find it in Gearset's results - where is it?
Kevin Boyle avatar
Written by Kevin Boyle
Updated over a week ago

Why is XML order of some metadata in the comparison results different?

Salesforce metadata API returns the XML in non-deterministic manner
Valerio avatar
Written by Valerio
Updated over a week ago

Why are there metadata differences in my freshly refreshed sandbox?

Refreshing does not clone your production.
Valerio avatar
Written by Valerio
Updated over a week ago

A note on deploying custom object permissions on new profiles

Working around a known issue when setting custom object permissions to false
Valerio avatar
Written by Valerio
Updated over a week ago

Why can't I see any Apex classes in my comparison?

Ali Daw avatar
Written by Ali Daw
Updated over a week ago

Common causes of slow validations or deployments

Why deployment times can vary at different times of the day and the underlying causes
Jason Mann avatar
Written by Jason Mann
Updated over a week ago

Changes to Flows in v44 of the metadata API

Valerio avatar
Written by Valerio
Updated over a week ago

Why is the 'Changed on' date sometimes incorrect?

Understanding why some metadata have incorrect 'Changed on' and 'Changed by' information
Valerio avatar
Written by Valerio
Updated over a week ago

Why 'Unknown' is sometimes displayed as the 'Changed by' value in the results table

In the results table, we sometimes display 'Unknown' in the 'Changed by' column instead of the name of the user responsible for the change
Stephen Chambers avatar
Written by Stephen Chambers
Updated over a week ago

Known issues when tracking Case Layouts across a time period

RelatedSolutionList may change without user interaction
Valerio avatar
Written by Valerio
Updated over a week ago

Incomplete permission report

Why are some results hidden from my permission report and how do I remove the warning?
Ben Scabbia avatar
Written by Ben Scabbia
Updated over a week ago

How to resolve the "QuickText is not a valid Tab" error when deploying Profiles

Error message "You can't edit tab settings for QuickText, as it's not a valid tab"
Valerio avatar
Written by Valerio
Updated over a week ago

Are you getting "Invalid api version" when deploying Apex classes?

Valerio avatar
Written by Valerio
Updated over a week ago

Can Gearset migrate the Email Message Relation object and its encryption setting?

Issues seen with deploying Shield Platform Encryption on EmailMessageRelation
Valerio avatar
Written by Valerio
Updated over a week ago

What can I do about the error message "Cannot modify managed object"?

Valerio avatar
Written by Valerio
Updated over a week ago

Custom metadata type "X_mdt" is not available in this organization

Deploying new custom metadata to a target
Nicole Bazarova avatar
Written by Nicole Bazarova
Updated over a week ago

How can I resolve the error 'No more than 10 columns may be specified in lookupPhoneDialogsAdditionalFields'?

Cause and solution for this Salesforce validation/deployment error
Carly Hammond avatar
Written by Carly Hammond
Updated over a week ago

Deploying Einstein Analytics with Gearset

Troubleshooting steps you can take to ensure a successful deployment
Claudia McPhail avatar
Written by Claudia McPhail
Updated over a week ago
Version control

Whitespace changes for DX repos

Why am I seeing changes where spacing is being removed?
Alex Walter avatar
Written by Alex Walter
Updated over a week ago

Structuring your source control repository

There are several options for your metadata's directory structure in source control
Oli Lane avatar
Written by Oli Lane
Updated this week

Common problems with viewing metadata in source control

Issues seen with repo directory structures
Valerio avatar
Written by Valerio
Updated over a week ago

Tips for comparing metadata in source control repositories

5 tips on working with source controlled metadata, structuring your repository, and working with package.xml files
Jason Mann avatar
Written by Jason Mann
Updated over a week ago

Connecting to popular on-premise source control systems

This article walks through how to connect to popular on-premise source control systems via username/password, and how to troubleshoot issues
Kevin Boyle avatar
Written by Kevin Boyle
Updated over a week ago

Where are my missing GitHub repositories in Gearset?

Revoke source control connections to find missing organization repositories or change GitHub account
Valerio avatar
Written by Valerio
Updated over a week ago

Changes to Gearset's XML formatting when writing to version control

Improving whitespace and XML formatting when writing to repositories
Jason Mann avatar
Written by Jason Mann
Updated over a week ago

Why do I need to re-authenticate my Bitbucket Cloud connection?

A guide to how to re-validate your connection and why it's necessary
Catherine Bacon avatar
Written by Catherine Bacon
Updated over a week ago

Does your Azure DevOps connection give the error "Gearset can't find any repositories"?

User with multiple Azure DevOps tenants can be connected to Gearset with the wrong one.
Valerio avatar
Written by Valerio
Updated over a week ago
Data loader

Understanding data deployment errors

Identifying and resolving issues when using Gearset's data loader
Jason Mann avatar
Written by Jason Mann
Updated over a week ago

Resolving data deployment errors: INVALID_CROSS_REFERENCE_KEY: Record Type ID

Troubleshooting errors with Record Types when deploying data
Oli Lane avatar
Written by Oli Lane
Updated over a week ago

Resolving data deployment errors: DUPLICATE_VALUE:duplicate value found

This article explains when and why the DUPLICATE_VALUE:duplicate value found error occurs, and how to fix it
Tom Smith avatar
Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: DUPLICATE_VALUE & DUPLICATE_EXTERNAL_ID

This article explains when and why the DUPLICATE_VALUE and DUPLICATE_EXTERNAL_ID errors occur, and how to fix them
Tom Smith avatar
Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: DUPLICATES_DETECTED

This article explains when and why the DUPLICATES_DETECTED error occurs, and how to fix it
Simon Breslaw avatar
Written by Simon Breslaw
Updated over a week ago

Resolving data deployment errors: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY

This article explains when and why the CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY error occurs and how to fix it
Tom Smith avatar
Written by Tom Smith
Updated over a week ago

Resolving data deployment errors: FIELD_CUSTOM_VALIDATION_EXCEPTION

This article explains when and why the FIELD_CUSTOM_VALIDATION_EXCEPTION error occurs, and how to fix it
Simon Breslaw avatar
Written by Simon Breslaw
Updated over a week ago

Resolving data deployment errors: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST

This article explains when and why the INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST error occurs, and how to fix it
Simon Breslaw avatar
Written by Simon Breslaw
Updated over a week ago

Resolving data deployment errors: REQUIRED_FIELD_MISSING

This article explains when and why the REQUIRED_FIELD_MISSING error occurs, and how to fix it
Simon Breslaw avatar
Written by Simon Breslaw
Updated over a week ago