Skip to content

Instruction view

Auto matches the current browser width. Choose a view to compare the instructions for this article.

Show instructions for

Profile and Appearance

Profile holds the account fields you own — your photo, username, and password — plus the personal preferences that decide what you see. Appearance, reached from the same More sheet, decides how the app looks to you, and only to you.

Open your Profile

Desktop

  1. Choose the round Profile button in the header, top-right of every page.

Phone

  1. Choose the round Profile button in the header, top-right of every page — it isn't one of the bottom tabs.

The page opens on your avatar, username, and role, then Your reading (Read, Reading, DNF, and Rated counts, each linking to that Shelf), an explanation of where your books land, an Appearance section, your API tokens, and your account actions at the bottom.

Update your profile photo

Desktop

The Profile page's avatar and Add a photo button, with your username and role beside them.

  1. Add a photo (or Change photo, once you have one) uploads a new avatar image.
  2. Your username and role are shown here.
  1. On your Profile page, choose Add a photo and pick an image file. The page reloads with your photo filling the avatar circle, the button now reads Change photo, and a Remove photo button appears beside it.
  2. Choose Remove photo to go back to your initials.

Phone

The Profile page's avatar and Add a photo button, with your username and role beside them.

  1. Add a photo (or Change photo, once you have one) uploads a new avatar image.
  2. Your username and role are shown here.
  1. On your Profile page, choose Add a photo and pick an image file. The page reloads with your photo filling the avatar circle, the button now reads Change photo, and a Remove photo button appears beside it.
  2. Choose Remove photo to go back to your initials.

Until you add a photo, your avatar shows your initials on a coloured fill.

Change your password

Desktop

The Change username and Change password links near the bottom of your Profile page.

  1. Change username opens the username form.
  2. Change password opens the password form.
  1. On your Profile page, choose Change password.
  2. Enter your Current password, a New password, and repeat it in Repeat new password, then choose Update password.

A wrong current password re-renders the form with "That current password doesn't match what we have on record." and changes nothing:

The Change password form re-rendered with a wrong-current-password error.

  1. A wrong current password re-renders the form with this message.

Phone

The Change username and Change password links near the bottom of your Profile page.

  1. Change username opens the username form.
  2. Change password opens the password form.
  1. On your Profile page, choose Change password.
  2. Enter your Current password, a New password, and repeat it in Repeat new password, then choose Update password.

A wrong current password re-renders the form with "That current password doesn't match what we have on record." and changes nothing:

The Change password form re-rendered with a wrong-current-password error.

  1. A wrong current password re-renders the form with this message.

Once it succeeds, you land back on your Shelf; sign out and back in with the new password to confirm it took. Your existing session keeps working either way — a password change does not sign out any device you're already using.

Change your username

Desktop

  1. On your Profile page, choose Change username.
  2. Enter your Current password and a New username, then choose Update username.

A name someone else already has re-renders the form with "Username '<name>' is already taken." and changes nothing:

The Change username form re-rendered with an already-taken-username error.

  1. A taken username re-renders the form with this message.

Phone

  1. On your Profile page, choose Change username.
  2. Enter your Current password and a New username, then choose Update username.

A name someone else already has re-renders the form with "Username '<name>' is already taken." and changes nothing:

The Change username form re-rendered with an already-taken-username error.

  1. A taken username re-renders the form with this message.

Submitting your own current username is a no-op; success returns you to your Profile page under the new name, and the old name no longer signs you in.

Choose which automatic Shelves appear

The Lists section of your Profile lets you turn each automatic Shelf on or off.

Desktop

The Lists preferences block on your Profile page, with one checkbox per automatic Shelf.

  1. Each checkbox turns one automatic Shelf on or off.

Phone

The Lists preferences block on your Profile page, with one checkbox per automatic Shelf.

  1. Each checkbox turns one automatic Shelf on or off.

Where your books land

Your Profile page explains the file-share path in plain terms: every Book you request is copied to an iCloud folder shared with your account, the Books app on your iPhone or iPad picks it up from there automatically, and nothing is ever removed from that folder once a Book arrives. See Library, File Shares, and Downloads to browse that folder directly.

Choose your theme and mode

Desktop

The More sheet's Appearance section, showing the Theme and Mode button groups.

  1. Theme switches between the app's four palettes.
  2. Mode switches between Light, Dark, and System.
  1. In the header, choose More, then under Appearance choose a Theme — Neutral, Midnight, Boudoir, or Seerr.
  2. Choose a Mode — Light, Dark, or System, which follows your device's own setting.

Phone

The More sheet's Appearance section, showing the Theme and Mode button groups.

  1. Theme switches between the app's four palettes.
  2. Mode switches between Light, Dark, and System.
  1. In the bottom tab bar, choose More, then under Appearance choose a Theme — Neutral, Midnight, Boudoir, or Seerr.
  2. Choose a Mode — Light, Dark, or System, which follows your device's own setting.

Every figure in this guide — on every page, not only this one — is captured in the Neutral theme's Dark mode. Choosing a different theme or mode changes only what you see: your own screen may not match these pictures, even though every control sits in exactly the same place.

Create and manage an API token

Desktop

The API tokens section after issuing a new token, showing its one-time secret and its entry in the token list.

  1. A newly issued token's secret is shown exactly once, right here — copy it now.
  2. Each issued token then lists its name and an active or revoked chip.
  1. On your Profile page, under API tokens, name the token — something that reminds you what will use it, like laptop script — and choose Issue token.
  2. Copy the secret shown immediately. It's shown this one time only; the page never displays it again.
  3. Choose Revoke beside an active token to disable it. Revoking never deletes the row — it stays listed with a revoked chip instead of active.

Phone

The API tokens section after issuing a new token, showing its one-time secret and its entry in the token list.

  1. A newly issued token's secret is shown exactly once, right here — copy it now.
  2. Each issued token then lists its name and an active or revoked chip.
  1. On your Profile page, under API tokens, name the token — something that reminds you what will use it, like laptop script — and choose Issue token.
  2. Copy the secret shown immediately. It's shown this one time only; the page never displays it again.
  3. Choose Revoke beside an active token to disable it. Revoking never deletes the row — it stays listed with a revoked chip instead of active.