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

# Connecting Gmail

> Let Selly read order confirmations from your inbox and turn them into purchases.

Connect your Gmail and order confirmation emails become purchases on their own — retailer, order number, items and prices, no typing. When the order arrives, it becomes inventory.

Selly only ever **reads** your mail. It cannot send, delete, or change anything, and it only looks at order emails.

## Connecting

<Steps>
  <Step title="Open Settings → Integrations">
    Find the Gmail card and click **Add**.
  </Step>

  <Step title="Choose your Google account">
    Pick the account whose inbox receives your order confirmations.
  </Step>

  <Step title="Tick every box on Google's screen">
    This is the step that catches people out. Google shows the permissions as **separate checkboxes**, and they are not always ticked for you. If the one about reading your mail is left unticked, Google will still say you're signed in — but Selly gets no access to your inbox and no orders will ever arrive.

    Tick all of them, then click **Continue**.
  </Step>

  <Step title="Check it worked">
    You should come back to Settings with your address shown on the Gmail card. If something went wrong, the card tells you what — read it rather than assuming it connected.
  </Step>
</Steps>

<Warning>
  If you see **"the permission to read your mail wasn't granted"**, the box on Google's screen was left unticked. Click **Add** and go through it again, ticking every box. Nothing is wrong with your account.
</Warning>

## Connecting more than one inbox

Click **Add** again and pick another account. Orders from every connected inbox land in the same Selly account, which is what you want if you buy across a personal address and a business one.

## When it says "Reconnect needed"

The Gmail card tells you when an inbox has stopped delivering. Click **Add** and connect it again — and tick every box.

It happens for a few reasons, none of which mean you did something wrong:

<AccordionGroup>
  <Accordion title="The mail permission wasn't granted">
    The checkbox on Google's consent screen was missed. Reconnecting and ticking everything fixes it.
  </Accordion>

  <Accordion title="Access was withdrawn on Google's side">
    Removing Selly under your Google account's security settings, or in some cases changing your password, revokes the connection. Reconnect to restore it.
  </Accordion>

  <Accordion title="The account has no Gmail">
    A Google account created against a non-Google address (a Yahoo or Outlook one, say) has no Gmail mailbox to read. There's nothing to connect — use a real Gmail account, or forward your order emails to Selly instead.
  </Accordion>
</AccordionGroup>

<Note>
  Orders that arrived while an inbox was disconnected are not picked up afterwards. Forward those confirmation emails to your Selly forwarding address and they'll come through as normal.
</Note>

## What Selly does with an order email

<Steps>
  <Step title="Reads it">
    Retailer, order number, items, sizes and prices.
  </Step>

  <Step title="Creates the purchase">
    It appears on your Purchases page as **Ordered**.
  </Step>

  <Step title="Follows the shipping">
    A tracking number moves it to Shipped and then Delivered on its own.
  </Step>

  <Step title="Creates your inventory">
    On delivery, the items become inventory units with their cost already worked out.
  </Step>
</Steps>

Emails that aren't orders are ignored. If a particular retailer's confirmations never turn up as purchases, tell us which retailer — that's a gap we can close.