On occasion, when you arrive at https://app.gearset.com/ and try to log in with a Salesforce account, you may find you're unable to proceed after entering your Salesforce credentials - the browser serves up a blank page or your Salesforce credentials are showing as incorrect.

You may see below message:
"Please check your username and password. If you still can't log in, contact your Salesforce administrator."

You may also see the above message in a scenario where you're trying to connect a new Salesforce org to your Gearset account.

This article addresses some common resolutions to these problems.

The first thing to understand what org type you have: Salesforce (Production, Developer) accounts will authenticate against https://login.salesforce.com/, while Salesforce (Sandbox) accounts will authenticate against https://test.salesforce.com/.
​

As the different account types use two different authentication URL and flows but have a similar UI, it's easy to accidentally click on the wrong account type when logging into Gearset. It's always worth double-checking you're using the correct flow.

Similarly, when you add a new org connection to Gearset, make sure to select the correct organization from the dropdown menu as seen below.

If you choose the wrong type for the org that you trying to connect then your credentials will not be found and you won't be able to login, as you are trying to access a different organization type.
​
​Note: Your org admin can turn off authentication against login.salesforce.com or test.salesforce.com and enforce login via the orgs custom url. If this is the cause then please use the Custom Domain option to connect your org. Details can be found here

If you're still running into issues and aren't sure what is going wrong, then Login History from the Salesforce Setup menu is a great way to diagnose failed requests.

In the screenshot, you can see an attempt failed due to the wrong password, and you'll see a similar entry with invalid_grant|ip_restricted if there is an issue with Gearset connecting to your org.

You may find that your Salesforce credentials are showing as incorrect.

This is commonly because you are logging into

If this happens simply go back to the connection screen below and choose the correct organization, and that should allow the connection will be added to your org list on Gearset.

If that doesn't resolve it, you'll also want to check that Login Form is selected as an Authentication Service in your Authentication Configuration options. You can find this under Company Settings > My Domain:

If you are trying to join a team and you are seeing the error message above, then have a look at this guide here.

If so, then it may be that your org or profile doesn't have the IPs allowlisted. To address this issue please follow this guide.

If you encounter this issue where it does not redirect you back to Gearset after signing in using SAML, then please find out more here.