> ## Documentation Index
> Fetch the complete documentation index at: https://developers.plane.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Google OAuth

Plane already ships with out-of-the-box support for Google OAuth. This is the easiest option to configure for Google Workspace users.

## Configure Plane as an app on Google API Console

First, you will need to identify Plane as an approved OAuth app to Google.

1. Go to the [Google API console](https://console.cloud.google.com/apis) and create a new project.
2. Navigate to the **OAuth consent screen** under **APIs & Services**. Choose how you want to configure and register the Plane app, including your target users, and click **Create**.
   <Frame>
     <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/google/google-auth-1.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=9664390ff51934ef44d27edc21b6c922" alt="" width="1920" height="709" data-path="images/authentication/google/google-auth-1.png" />
   </Frame>
3. Configure the OAuth consent screen with information about the app.
   <Frame>
     <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/google/google-auth-2.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=fff84a950e723ce61938ae6c7596c405" alt="" width="1920" height="1178" data-path="images/authentication/google/google-auth-2.png" />
   </Frame>
4. Navigate to the **Credentials** screen, click **Create Credentials**, and select **OAuth client ID** from the options given.
   <Frame>
     <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/google/google-auth-3.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=cadeed975b2d0c8a10d886338000fe53" alt="" width="1920" height="796" data-path="images/authentication/google/google-auth-3.png" />
   </Frame>
5. Select **Web application** under the **Application type** dropdown list. Update the following fields.
   1. **Authorized JavaScript origins**\
      The HTTP origins that host your web application, e.g., `https://app.plane.so`
   2. **Authorized redirect URIs**\
      Append the path that users should be redirected to after they have authenticated with Google. `https://<plane.example.com>/auth/google/callback` and `https://<plane.example.com>/auth/mobile/google/callback/` where `<plane.example.com>` is your self-hosted instance's domain.
   3. Click **Create**.
   4. Get the Client ID and Client secret under **OAuth 2.0 Client IDs** on the **Credentials** screen.
      <Frame>
        <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/google/google-auth-4.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=ab142f6777776e43f9701c731e9ac82b" alt="" width="1920" height="1101" data-path="images/authentication/google/google-auth-4.png" />
      </Frame>

## Configure Plane

<Frame>
  <img src="https://mintcdn.com/planesoftwareinc/0KaIKJNVgKAyWkhv/images/custom-sso/google-oauth.png?fit=max&auto=format&n=0KaIKJNVgKAyWkhv&q=85&s=c13eba3b1dedba532bbf89e97d7ff527" alt="Google Oauth Configuration" width="4585" height="1347" data-path="images/custom-sso/google-oauth.png" />
</Frame>

1. Go to `Google` on the Authentication screen of `/god mode`.
2. Add the client ID + the client secret from Google API Console.
3. Click `Save `.

Your Plane instance should now work with `Sign in with Google`.

<Note>We don't restrict domains in with Google OAuth yet. It's on our roadmap.</Note>