Go to Gearset
All Collections
Troubleshooting
Troubleshooting
Resolving common issues with comparisons and deployments
+14
66 articles in this collection
Written by
Kevin Boyle,
Jason Mann,
Luke
and 14 others
Status updates
Gearset log4j statement Dec 2021
Written by
Valerio
Updated over a week ago
Incident explanation for API issue May 2021
Error "An internal server error has occurred"
Written by
Valerio
Updated over a week ago
Incident explanation for automation jobs Feb 2021
All schedule jobs failed to run on 27th of Feb 2021
Written by
Ben Roberts
Updated over a week ago
Incident explanation for API issue Apr 2020
Alternative error: "An unknown error occurred while logging in. Re-authorizing the org may help"
Written by
Valerio
Updated over a week ago
Incident explanation for Custom metadata issue Sep 2019
INVALID_TYPE: sObject type '__mdt' is not supported is the error message
Written by
Jason Mann
Updated over a week ago
Incident explanation for Winter '20 API issue Sep 2019
Incident explanation for Salesforce Winter '20 API issue
Written by
Jason Mann
Updated over a week ago
General
I've forgotten my Gearset login details, how can I retrieve this?
Written by
Valerio
Updated over a week ago
Running tests synchronously in a test monitor
How to change the behavior of your Salesforce org such that test monitor runs will run the tests sequentially instead of in parallel
Written by
Luke
Updated over a week ago
Custom metadata filter versus package.xml
Why doesn't my package.xml work?
Written by
Valerio
Updated over a week ago
Connections and authentication
Resolving issues logging into Gearset via Salesforce
Fixing common OAuth and cookie issues when connecting to your Salesforce org
Written by
Valerio
Updated over a week ago
Common authentication and comparison errors
Having trouble running a comparison? These are the most common causes and solutions
Written by
Jason Mann
Updated over a week ago
Comparisons and deployments
How can I resolve the error 'Cannot specify a gender for a gender neutral language'?
The cause and solution to this Salesforce validation/deployment error
Written by
Thomas Giffin
Updated over a week ago
How can I resolve the error "The resource data for the static resource ‘...’ appears to be missing, although the XML file is present..."?
Cause and solution for this static resource error
Written by
George Marino
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
Written by
Valerio
Updated over a week ago
How to use the bisection method to debug retrieval errors?
Written by
Valerio
Updated over a week ago
How to solve the Salesforce error "You can't edit tab settings for DelegatedAccount, as it's not a valid tab."
Written by
Valerio
Updated over a week ago
Why is my metadata deployed to source control in SFDX source or MDAPI format?
How to ensure that your metadata is deployed in the correct format
Written by
Valerio
Updated over a week ago
Which destructive changes does the metadata API not handle?
Written by
Valerio
Updated over a week ago
Gearset cannot retrieve standard tabs
And how Gearset can retrieve standard tab visibilities
Written by
Valerio
Updated over a week ago
Why are my managed package metadata components not showing up?
Searching for managed package metadata in your org to org comparisons
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?
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
Written by
Valerio
Updated over a week ago
Why are there metadata differences in my freshly refreshed sandbox?
Refreshing does not clone your production.
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
Written by
Valerio
Updated over a week ago
Why can't I see any Apex classes in my comparison?
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
Written by
Jason Mann
Updated over a week ago
Changes to Flows in v44 of the metadata API
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
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
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
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?
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"
Written by
Valerio
Updated over a week ago
How to resolve the Salesforce error INVALID_TYPE: Cannot use: WorkflowRule in this organization
Written by
Claudia McPhail
Updated over a week ago
Are you getting "Invalid api version" when deploying Apex classes?
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
Written by
Valerio
Updated over a week ago
What can I do about the error message "Cannot modify managed object"?
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
Written by
Valerio
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
Written by
Valerio
Updated over a week ago
Deploying Einstein Analytics with Gearset
Einstein Analytics is also known as Tableau CRM
Written by
Claudia McPhail
Updated over a week ago
Version control
Why do irrelevant validations show up in my pull request in GitHub?
How GitHub treats commits in determining brach protection rule checks
Written by
Ben Scabbia
Updated over a week ago
Issue with using AzureDevOps extension to resolve conflicts
Merging conflicts through the ADO web extension can go undetected by Gearset
Written by
Thomas Giffin
Updated over a week ago
Metadata missing when commit to git branches
Why are some objects not being checked into repositories?
Written by
Valerio
Updated over a week ago
Whitespace changes for DX repos
Why am I seeing changes where spacing is being removed?
Written by
Alex Walter
Updated over a week ago
Structuring your source control repository
Gearset supports the Metadata API and SFDX source format directory structure in source control
Written by
Oli Lane
Updated over a week ago
Common problems with viewing metadata in source control
Issues seen with repo directory structures
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
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
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
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
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
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.
Written by
Valerio
Updated over a week ago
Data loader
Understanding data deployment errors
Identifying and resolving issues when using Gearset's data loader
Written by
Jason Mann
Updated over a week ago
Resolving data deployment errors: DUPLICATES_DETECTED
This article explains when and why the DUPLICATES_DETECTED errors occur, and how to fix them
Written by
Alex Walter
Updated over a week ago
Resolving data deployment errors: INVALID_CROSS_REFERENCE_KEY: Record Type ID
Troubleshooting errors with Record Types when deploying data
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
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
Written by
Tom Smith
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
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
Written by
David Runciman
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
Written by
David Runciman
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
Written by
David Runciman
Updated over a week ago
Data backup
Why can't I restore [Object]History from my data backup?
Written by
Toby Newman
Updated over a week ago
Why are there so many new records in my latest data backup run?
Adding support for previously excluded objects means their records will appear as new.
Written by
Ali Daw
Updated over a week ago
Why do all the records in my external objects appear to be deleted in my latest data backup run?
External objects are now excluded from data backup runs, as that data resides outside of your Salesforce org
Written by
Luke
Updated over a week ago
Replicating issues
How come Gearset doesn't show my item?
Part 1 of 3 of how to use the metadata API with Workbench
Written by
Valerio
Updated over a week ago
How to replicate deployment errors with other tools?
Part 2 of 3 of how to use the metadata API with Workbench
Written by
Valerio
Updated over a week ago
How to replicate metadata download speeds with Workbench
Part 3 of 3 of Workbench series - why do comparisons take a lot of time?
Written by
Valerio
Updated over a week ago