CommunityHire an ExpertSign Up
IntegrationsGoogle Sign-in

Google Sign-in

Let people into your Softr app with their Google account — create an OAuth client in Google Cloud, then paste the credentials into your app's authentication settings.

Google Sign-in puts a Continue with Google button on your app’s sign-in and sign-up forms. People who already have a Google account get in with one click, and you never hold a password for them.

Setting it up happens in two places: you create an OAuth client in the Google Cloud console, then paste its client ID and secret into Softr. Keep both tabs open — you will be moving between them.

Before you start

A Google account that can create Cloud projects

Creating a project needs the resourcemanager.projects.create permission. Personal Google accounts have it; a work account in a Google Cloud organization often does not, and the No organization row in the project picker will be marked with a warning triangle. If that happens, ask whoever administers your Google Cloud organization to create the project — or to grant you the permission — and carry on from step 2.

Your app's URL, exactly as visitors see it

Open your published app and copy the address out of the browser bar. On a Softr subdomain that is https://yourapp.softr.app, with no www.; on a custom domain it is whatever host you connected. You need the scheme and host only — no trailing slash, no path.

Create your Google OAuth client

Create a Google Cloud project

In the Google Cloud console, give the project a name. Google derives a project ID from it, which cannot be changed later. If your account belongs to an organization you also have to pick a Parent resource. Click Create.

The New Project form with a project name filled in and the Create button below it

Naming a new project in the Google Cloud console.

Name the app people will consent to

Go to Google Auth Platform → Branding. App name and User support email are what people see on Google’s consent screen the first time they sign in, so use the name of your portal rather than the project ID. Click Save.

The App information section of the Branding page, with the app name and user support email fields outlined

App name and support email on the Branding page.

Choose who can sign in — and publish the app

Open Audience. Two settings on this page decide who gets in.

The Audience page showing publishing status Testing and user type External

Publishing status and user type on the Audience page.
  1. Publishing status. A new project starts in Testing, and while it is in Testing only the Google accounts listed under Test users can sign in — up to 100 of them. Click Publish app to move it into production.
  2. User type. External lets anyone with a Google account sign in. Internal appears only if your Google account belongs to a Google Workspace organization, and limits sign-in to that organization.

Note which User type you picked. You set the same value on the Softr side.

Create the OAuth client

Go to Clients → Create client. Set Application type to Web application and give the client a name. The name is only used to identify the client in the console; nobody signing in ever sees it.

The Create OAuth client ID form with application type set to Web application and a client name entered

Choosing the Web application client type.

Add your app's URL to both lists

Under Authorized JavaScript origins, click Add URI and paste your app’s URL. Then do the same under Authorized redirect URIs. Click Create.

The two URI lists on the OAuth client form, each holding the app's URL

The same app URL added as a JavaScript origin and a redirect URI.

Copy the client ID and secret

Google shows the new client’s ID and secret as soon as it is created. Copy both before you close the panel.

Add the credentials to Softr

Switch Google Sign-in on

In Softr Studio, open your app and go to Users → Authentication. Turn on the Google Sign-in toggle (1), then click the gear (2) to open its settings.

The Authentication method list with the Google Sign-in toggle switched on and its gear icon beside it

The Google Sign-in row in the Authentication method list.

Paste the credentials

Paste the Google client ID and Google client secret you copied from the console (1). Then set User type (2) to the same value you chose on the Audience page.

The Google Sign-in settings dialog showing the client ID and secret fields, the user type control, and the email domains field

The Google Sign-in settings dialog with Internal selected.

With Internal, a Google Sign-in email domains field appears. Anyone whose email address is on one of these domains is always sent to Google to log in, even when your app also offers email or SSO. Choosing External hides the field, because an external client accepts any Google account.

The same dialog with user type set to External and no email domains field beneath it

With External selected, the email domains field is not shown.

Save and publish

Click Save, then publish your app so the change reaches the live site. The amber dot beside Google Sign-in should disappear.

What people see

Continue with Google appears above the email field on both the sign-in and the sign-up form. The first time someone uses it, Google shows a consent screen carrying the app name and support email you set under Branding.

An app login page with Continue with Google above the SSO button and the email field

The Continue with Google button on a published app's login page.

Signing in this way creates or matches a record in your app’s users list on the email address the Google account carries.

Troubleshooting

Google refuses the request before showing the account chooser

The URL registered on the OAuth client does not match the address the browser is on. Compare them character for character: http against https, www. present or absent, and no trailing slash. If you have just changed the client, give it a few minutes — Google warns that client changes can take up to a few hours to propagate.

Some people can sign in and others cannot

Either the Google Cloud project is still in Testing, in which case only the accounts on the test-user list are allowed, or the client’s User type is Internal and the people being refused are outside your Google Workspace organization. Both live on the Audience page.

The amber dot beside Google Sign-in will not clear

Softr marks a method Setup is incomplete until it has a client ID and secret saved. Reopen the gear and check both fields are filled and saved.

Only people on certain domains are sent to Google

That is the Google Sign-in email domains field doing its job. Clear it if you want those people to be able to use email or SSO as well.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Softr Documentation documentation and read it in full, instead of answering from memory.

https://docs.softr.io/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://docs.softr.io/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.