Help

Connecting Gmail with an app password

About a minute. Your Google account needs 2-Step Verification.

In short. Subik reads your Gmail with an app password: a 16-letter code you create in your Google account and paste into Subik. The code stays on your phone, and Subik only reads your mail. Subik never asks for your Google password.

What an app password is

A code Google creates for one app, so it can sign in to your Gmail without your Google password. Google shows it once, as four groups of four letters, like abcd efgh ijkl mnop. It is separate from your Google password, and you can delete it at any time without changing anything else.

Google’s page warns that app passwords are less secure, give complete access, and shouldn’t be shared. That is accurate: the code would let an app do anything with your mail. That is why it never leaves your phone, and why Subik only reads: it never sends, deletes or changes email.

The steps

  1. In Subik, tap Connect Gmail, then Next and Open Google. If Google shows a list of your accounts, pick the Gmail to connect. Google’s App passwords page opens in your phone’s browser, never inside Subik. On iPhone, iOS first asks to use google.com to sign in, sometimes twice: tap Continue each time.
  2. Sign in, if Google asks. Google may also ask you to verify it’s you: with your password, a passkey, or a code from another phone or tablet signed in to that account.
  3. Under App name, type “Subik” and tap Create.
  4. Google shows your code. Its dialog has no Copy button: press and hold the code, drag across all four groups, then tap Copy.
  5. Close Google and tap Paste in Subik (Paste code on Android). On iPhone, close Google with its ✕ button. On Android, if you copied the whole code, Subik fills it in for you. Subik checks the code with Gmail, connects, and clears it from your clipboard.

Copied only part of it? Subik tells you. Go back and drag across all four groups, or type the 16 letters yourself. Spaces and capitals don’t matter.

If you can’t find App passwords

2-Step Verification is probably off. Google requires it for app passwords. In Subik, tap No 2-Step Verification? We’ll help (or, on the code screen, Didn’t get a code? → I can’t find App passwords) and then Open Google security. Or, in your Google Account, open Security & sign-in, find “How you sign in to Google”, select Turn on 2-Step Verification and follow the steps (Google’s guide). Then come back and create the code.

Accounts that can’t create one

Google doesn’t offer app passwords for:

  • work, school and other organisation accounts;
  • accounts with Advanced Protection;
  • accounts whose 2-Step Verification uses only security keys.

If yours is one of these, connect another Gmail, or add your subscriptions by hand in Subik.

If something goes wrong

  • “That code didn’t work” Copy all 16 letters of the newest code. A code stops working when you delete it or change your Google password; then create a new one.
  • Google asks you to verify it’s you, and you can’t. Before it opens App passwords, Google sometimes wants a passkey or a code from another phone or tablet signed in to that account. Use one of the ways it offers. If none works for you, connect another Gmail, or add your subscriptions by hand in Subik.
  • You closed Google before copying. Google shows each code only once. Create another named “Subik”. You can delete the unused one later.
  • “One Gmail setting is off” In Gmail on a computer, open Settings → See all settings → Labels and tick Show in IMAP for All Mail. Then try again.

Removing access

  • In Subik: Settings → Privacy & Data → Connected inboxes → Disconnect. Subik forgets the code on your phone and stops reading that Gmail. Subscriptions it already found stay.
  • At Google: open App passwords and delete “Subik”. The code stops working. Changing your Google password removes every app password too.

What Subik reads and what reaches our servers: Privacy Policy, section 3.2. Questions: subik@theoatlabs.com.