docs review pt2

SarahSoutoul · SarahSoutoul · commit 0168ba508086 · 2025-12-05T12:35:59.000-06:00
diff --git a/docs/_partials/authentication/social-connections/enable-google-social-connection.mdx b/docs/_partials/authentication/social-connections/enable-google-social-connection.mdx
@@ -0,0 +1,5 @@
+1. In the Clerk Dashboard, navigate to the [**SSO connections**](https://dashboard.clerk.com/~/user-authentication/sso-connections) page.
+1. Select **Add connection** and select **For all users**.
+1. In the **Choose provider** dropdown, select **Google**.
+1. Ensure that both **Enable for sign-up and sign-in** and **Use custom credentials** are toggled on.
+1. Save the **Authorized Redirect URI** somewhere secure. Keep this modal and page open.
diff --git a/docs/guides/configure/auth-strategies/sign-in-with-google.expo.mdx b/docs/guides/configure/auth-strategies/sign-in-with-google.expo.mdx
@@ -15,24 +15,23 @@ sdk: expo
       title: "A Google Developer account is required.",
       link: "https://console.developers.google.com/",
       icon: "user-circle",
-    }
+    },
+    {
+      title: "Follow the Expo quickstart",
+      link: "/docs/expo/getting-started/quickstart",
+      icon: "expo",
+    },
   ]}
 />
 
-[Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=en) helps you easily and securely sign in to third-party apps or services with your Google Account, without having to enter a username and password repeatedly across different services.
-
-This guide will teach you how to add native Sign in with Google to your Clerk Expo application. This is different from Google OAuth - if you want to use Google OAuth, see the [dedicated guide](/docs/guides/configure/auth-strategies/social-connections/google).
+This guide will teach you how to add native [Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=en) to your Clerk Expo application. This is different from Google OAuth - if you want to use Google OAuth, see the [dedicated guide](/docs/guides/configure/auth-strategies/social-connections/google).
 
 To make the setup process easier, it's recommended to keep two browser tabs open - one for the [Clerk Dashboard](https://dashboard.clerk.com/~/user-authentication/sso-connections) and one for your [Google Cloud Console](https://console.cloud.google.com/).
 
 <Steps>
   ## Enable Google as a social connection
 
-  1. In the Clerk Dashboard, navigate to the [**SSO connections**](https://dashboard.clerk.com/~/user-authentication/sso-connections) page.
-  1. Select **Add connection** and select **For all users**.
-  1. In the **Choose provider** dropdown, select **Google**.
-  1. Ensure that both **Enable for sign-up and sign-in** and **Use custom credentials** are toggled on.
-  1. Save the **Authorized Redirect URI** somewhere secure. Keep this modal and page open.
+  <Include src="_partials/authentication/social-connections/enable-google-social-connection.mdx" />
 
   ## Configure Google Cloud Console
 
@@ -42,28 +41,18 @@ To make the setup process easier, it's recommended to keep two browser tabs open
 
   1. Navigate to the [Google Cloud Console](https://console.cloud.google.com/).
   1. Select an existing project or [create a new one](https://console.cloud.google.com/projectcreate). You'll be redirected to your project's **Dashboard** page.
-  1. Enable the **Google+ API** for your project.
+  1. Enable the [**Google+ API**](https://console.cloud.google.com/apis/library/plus.googleapis.com?project=expo-testing-480017) for your project.
 
   ### Create OAuth 2.0 Credentials
 
-  You'll need to create three sets of credentials:
+  You'll need to create **three sets of credentials**:
 
-  #### Web Client ID (for token verification)
+  #### iOS Client ID
 
   1. Navigate to **APIs & Services**. Then, select **Credentials**.
   1. Next to **Credentials**, select **Create Credentials**. Then, select **OAuth client ID**. You might need to [configure your OAuth consent screen](https://support.google.com/cloud/answer/6158849#userconsent). Otherwise, you'll be redirected to the **Create OAuth client ID** page.
-  1. For the **Application type**, select **Web application**.
-  1. Add a name (e.g., "Web client for token verification").
-  1. Under **Authorized redirect URIs**, select **Add URI** and paste the **Authorized Redirect URI** you saved from the Clerk Dashboard.
-  1. Select **Create**. A modal will open with your **Client ID** and **Client Secret**.
-  1. Copy and save the **Client ID** - you'll need this for `EXPO_PUBLIC_CLERK_GOOGLE_WEB_CLIENT_ID`.
-  1. Copy the **Client ID** and **Client Secret** and paste them into the respective fields in the Clerk Dashboard. Then select **Add connection** to complete the setup.
-
-  #### iOS Client ID
-
-  1. In the same project, create another client. Next to **Credentials**, select **Create Credentials**. Then, select **OAuth client ID**.
   1. For the **Application type**, select **iOS**.
-  1. Add your iOS **Bundle ID** (from your `app.json` or `app.config.ts`).
+  1. Add your iOS **Bundle ID**.
   1. Select **Create**. A modal will open with your **Client ID**.
   1. Copy ans save the **Client ID** - you'll need this for `EXPO_PUBLIC_CLERK_GOOGLE_IOS_CLIENT_ID`.
 
@@ -84,6 +73,18 @@ To make the setup process easier, it's recommended to keep two browser tabs open
   1. Select **Create**. A modal will open with your **Client ID**.
   1. Copy and save the **Client ID** - you'll need this for `EXPO_PUBLIC_CLERK_GOOGLE_ANDROID_CLIENT_ID`.
 
+  #### Web Client ID (for token verification)
+
+  1. In the same project, create another client. Next to **Credentials**, select **Create Credentials**. Then, select **OAuth client ID**.
+  1. For the **Application type**, select **Web application**.
+  1. Add a name (e.g., "Web client for token verification").
+  1. Under **Authorized redirect URIs**, select **Add URI** and paste the **Authorized Redirect URI** you saved from the Clerk Dashboard.
+  1. Select **Create**. A modal will open with your **Client ID** and **Client Secret**. Save these values somewhere secure. You'll need these for the following steps.
+
+  ## Set the Client ID and Client Secret in the Clerk Dashboard (from your web client)
+
+  <Include src="_partials/authentication/social-connections/set-client-id-secret" />
+
   ## Add your iOS application to Clerk
 
   Add your iOS application to the [**Native Applications**](https://dashboard.clerk.com/~/native-applications) page in the Clerk Dashboard. You will need your iOS app's **App ID Prefix** (Team ID) and **Bundle ID**.
@@ -103,6 +104,7 @@ To make the setup process easier, it's recommended to keep two browser tabs open
 
   # iOS only: URL scheme for Google Sign-In callback
   # Format: com.googleusercontent.apps.{IOS_CLIENT_ID_PREFIX}
+  # IOS_CLIENT_ID_PREFIX is the part of your iOS Client ID before ".apps.googleusercontent.com"
   EXPO_PUBLIC_CLERK_GOOGLE_IOS_URL_SCHEME=com.googleusercontent.apps.your-ios-client-id
   ```
 
diff --git a/docs/guides/configure/auth-strategies/sign-in-with-google.mdx b/docs/guides/configure/auth-strategies/sign-in-with-google.mdx
@@ -15,24 +15,23 @@ sdk: android
       title: "A Google Developer account is required.",
       link: "https://console.developers.google.com/",
       icon: "user-circle",
-    }
+    },
+    {
+      title: "Follow the Android quickstart",
+      link: "/docs/android/getting-started/quickstart",
+      icon: "android",
+    },
   ]}
 />
 
-[Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=en) helps you easily and securely sign in to third-party apps or services with your Google Account, without having to enter a username and password repeatedly across different services.
-
-This guide will teach you how to add native Sign in with Google to your Clerk apps on Android platforms. This is different from Google OAuth - if you want to use Google OAuth, see the [dedicated guide](/docs/guides/configure/auth-strategies/social-connections/google).
+This guide will teach you how to add native [Sign in with Google](https://support.google.com/accounts/answer/12849458?hl=en) to your Clerk apps on Android platforms. This is different from Google OAuth - if you want to use Google OAuth, see the [dedicated guide](/docs/guides/configure/auth-strategies/social-connections/google).
 
 To make the setup process easier, it's recommended to keep two browser tabs open - one for the [Clerk Dashboard](https://dashboard.clerk.com/~/user-authentication/sso-connections) and one for your [Google Cloud Console](https://console.cloud.google.com/).
 
 <Steps>
   ## Enable Google as a social connection
 
-  1. In the Clerk Dashboard, navigate to the [**SSO connections**](https://dashboard.clerk.com/~/user-authentication/sso-connections) page.
-  1. Select **Add connection** and select **For all users**.
-  1. In the **Choose provider** dropdown, select **Google**.
-  1. Ensure that both **Enable for sign-up and sign-in** and **Use custom credentials** are toggled on.
-  1. Save the **Authorized Redirect URI** somewhere secure. Keep this modal and page open.
+  <Include src="_partials/authentication/social-connections/enable-google-social-connection.mdx" />
 
   ## Create the Google Developer Android client
 
diff --git a/docs/guides/configure/auth-strategies/social-connections/apple.mdx b/docs/guides/configure/auth-strategies/social-connections/apple.mdx
@@ -21,7 +21,7 @@ description: Learn how to allow users to sign up and sign in to your Clerk app w
 Enabling OAuth via [Sign in with Apple](https://developer.apple.com/sign-in-with-apple/) allows your users to sign in and sign up to your Clerk app with their Apple ID.
 
 > [!IMPORTANT]
-> This guide explains how to configure Sign in with Apple for web based flows. To configure native Sign in with Apple on native applications (iOS), see the [dedicated guide](/docs/guides/configure/auth-strategies/sign-in-with-apple).
+> This guide explains how to configure Sign in with Apple for web based flows. To configure native Sign in with Apple on native applications, see the [dedicated guide](/docs/guides/configure/auth-strategies/sign-in-with-apple).
 
 ## Configure for your development instance
 
diff --git a/docs/guides/configure/auth-strategies/social-connections/google.mdx b/docs/guides/configure/auth-strategies/social-connections/google.mdx
@@ -41,11 +41,7 @@ To make the setup process easier, it's recommended to keep two browser tabs open
 <Steps>
   ### Enable Google as a social connection
 
-  1. In the Clerk Dashboard, navigate to the [**SSO connections**](https://dashboard.clerk.com/~/user-authentication/sso-connections) page.
-  1. Select **Add connection** and select **For all users**.
-  1. In the **Choose provider** dropdown, select **Google**.
-  1. Ensure that both **Enable for sign-up and sign-in** and **Use custom credentials** are toggled on.
-  1. Save the **Authorized Redirect URI** somewhere secure. Keep this modal and page open.
+  <Include src="_partials/authentication/social-connections/enable-google-social-connection.mdx" />
 
   ### Create a Google Developer project
 
