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

# Settings and account

> Units, display name, and how sign-in works.

## Unit system

**Settings → Unit system** switches the whole app between **Metric** and **US**.

This is a display preference and nothing more. Brewgravity always stores kilograms,
grams, litres, degrees Celsius, and minutes; the setting changes what you see
and what you type into. Switching back and forth does not convert or damage
anything, and the API always speaks metric regardless of what you have selected.

| Metric | US      |
| ------ | ------- |
| kg / g | lb / oz |
| litres | gallons |
| °C     | °F      |

## Display name

Your display name appears in the sidebar. Change it in **Settings** and press
**Save name**. Your email address is shown but cannot be changed from here.

## Sign-in methods

<CardGroup cols={3}>
  <Card title="Email and password" icon="envelope">
    Requires email verification before the account is usable. Password resets
    are emailed on request.
  </Card>

  <Card title="Magic link" icon="link">
    A one-time sign-in link, valid for five minutes. No password involved.
  </Card>

  <Card title="Google" icon="google">
    Sign in with Google. An existing account on the same email address is linked
    automatically rather than duplicated.
  </Card>
</CardGroup>

All three land you in the same account as long as the email address matches, so
you can start with a password and switch to magic links later without losing
anything.

## Sessions

Brewgravity uses cookie-based sessions. On a shared or borrowed computer, sign
out when you are done rather than just closing the tab.

## API keys

Programmatic access uses API keys rather than your session cookie. See
[Authentication](/docs/api-reference/authentication).