# Accounts & SSO: Link or unlink your Google sign-in

Source: https://qurangallery.com/docs/accounts/connected-accounts

> Link Google to your Quran Gallery account so you can sign in with it as well as your password, and unlink it when you want to. Keep at least one method.

The **Login methods** card in your settings lets you mix and match the ways you sign in. You can have either or both of these:

- **Email & Password** — your password-based login.
- **Google** — sign in with your Google account.

Connecting more than one is a good idea. It gives you a backup if one provider has an outage, and it's the only way to keep using one specific method while removing another safely.

## How the Login methods card looks

After you sign in, open **Settings**. The **Login methods** card lists both methods stacked vertically. Each row shows whether it's currently **Connected** or **Not connected**, and which email or account ID is on file.

A signed-in OAuth-only account (no password set) shows the same card with the **Email & Password** row marked **Not connected** and a **Set up** button — that's the path documented in [Set a password](https://qurangallery.com/docs/accounts/set-password):

Buttons on each row let you:

- **Set up** / **Connect** — start the provider's sign-in flow and attach it to your account.
- **Change** — disconnect and immediately re-connect (used when you want to switch which Google account is attached).
- **Disconnect** (the unlink icon) — remove the provider from your account.

## Connecting Google

1. **Settings → Login methods → Google → Connect Google**.
2. A Google sign-in window opens. Pick the account you want to attach and approve the access.
3. You're returned to Settings. The Google row now shows **Connected** with the account's email.

Quran Gallery will accept future **Continue with Google** sign-ins for this account.

**The Google account's email must match your Quran Gallery account email.** If you pick a Google account with a different email, the connect attempt is rejected to prevent silent identity merging. To use a different Google email, change your Quran Gallery email first (see [Profile](https://qurangallery.com/docs/accounts/profile)), then connect.

## Changing a connected provider

To switch from one Google account to another without temporarily disconnecting:

1. **Settings → Login methods → Google → Change**.
2. The current connection is removed, then the provider's sign-in page opens immediately so you can pick a different account.

This is shorter than disconnect → reconnect but does the same two things. You'll need to have at least one **other** login method connected (Password or the other provider), otherwise the change is rejected to stop you locking yourself out.

## Disconnecting a provider

1. **Settings → Login methods → Google**.
2. Click the unlink icon to the right of **Change**.
3. A confirm/cancel prompt appears. Click **Disconnect**.

After disconnect, **Continue with [provider]** will no longer sign you in to this account. Your data is untouched — only the link from this third-party identity to your Quran Gallery account is removed.

### The last-method rule

You **cannot disconnect your only login method**. If Google is the only thing connected, the Disconnect button is disabled with a tooltip telling you to set up another method first.

Why? Without any connected method, you'd have no way to sign in next time. The same rule applies if Google is your only method. There must always be at least one way to get back in.

## What happens to my data when I disconnect?

Disconnecting Google:

- Does **not** delete your Quran Gallery account.
- Does **not** delete your name, avatar, email, preferences, bookmarks, notes, hifz progress, listening history, or anything else.
- Does **not** affect your active sessions — you stay signed in everywhere you currently are.
- **Does** remove the access token Quran Gallery had for that provider.

If you want to fully wipe your account, see [Delete your account](https://qurangallery.com/docs/accounts/account-deletion).

## Common errors

| Error                                         | What it means                                                                                                  |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| "Account already linked to a different user"  | The Google account is connected to a different Quran Gallery account. Sign out of that one first. |
| "Different emails not allowed"                | The provider's email doesn't match your Quran Gallery email. Change one or the other to match.                 |
| "You can't disconnect your only login method" | Set up another login method first, then come back to disconnect this one.                                      |
| "Could not start the connection"              | The connect popup was blocked, or the network call timed out. Re-try.                                          |

## Next steps

- [Open account settings](https://accounts.qurangallery.com/settings)
- [Turn on two-factor authentication (2FA)](https://qurangallery.com/docs/accounts/two-factor-authentication)
- [Your profile (name, avatar, email)](https://qurangallery.com/docs/accounts/profile)
- [Your Quran Gallery account](https://qurangallery.com/docs/accounts/overview)
