Profile, notifications and appearance
This page is for anyone who uses the editor. It shows how to change your name and details, choose what you are told about, and make the editor look the way you like.
Each of these is a page in the Your account menu. To open it, choose your name in the side bar. You find Profile, Notifications, Appearance and Privacy there.
Before you start
- You need to be signed in for the menu. Without an account, the side bar shows Guest instead of your name, and there is no Your account menu. Your profile and your inbox belong to your account.
- Without an account, choices stay in this browser. Appearance you choose while signed out is kept in this browser only.
- Any plan, any role. These settings are yours alone. Nobody else changes them for you.
Your profile
Open Your account ▸ Profile. At the top you see your initials, your name and your email address.
Under About you:
- Name. It is shown on your comments, your suggestions and the versions you publish. Type a new name, then press Enter or leave the field. The page says Saved. A name can't be left empty: the page says "Your name can’t be empty: it is how people see you", and puts your name back.
- Title. A few words about what you do, such as "Support lead". It is seen beside your name. It saves the same way, and you can leave it empty.
- Email. Your sign-in address. You can see it here, but you can't change it in the editor or on the sign-in pages. To change it, send us a request and choose My account.
Under Where you are:
- Time zone. Choose Automatic, the time zone of your device, or UTC. It is kept with your account. The editor shows times in your device's own time zone.
- Language. The language you use. The editor switches to it if it is translated into it, and reloads. The assistant also starts in this language. It then answers in whatever language you write to it.
Notifications
Open Your account ▸ Notifications. When some are unread, the menu says so, such as Notifications · 3 unread.
Your inbox
When you are signed in, the page starts with your Inbox. It shows what happened, newest first: who did what, on which instruction.
- Open takes you to the instruction, and marks the notification as read.
- Mark all as read marks them all at once.
- When the inbox is empty, it says Nothing yet.
These come to your inbox:
- Someone suggests a change to an instruction you maintain, or comments, or mentions you.
- A new version of an instruction you maintain is published.
- Someone gives you access, adds you to an organization, invites you, or changes your role.
- An export you asked for is ready.
- Someone asks you for access to an instruction.
- A publish you scheduled has run, or an agent you deployed needs someone to sign it in.
Answer an access request
When someone asks for access to an instruction you look after, the request is in your inbox. You can answer it there:
Choose the access to give
The row says what they asked for, such as "Asks to suggest". Next to it, choose what to give them: read, suggest or maintain. It starts as what they asked for.
Approve or decline
Choose Approve or Decline. A message says, for example, "Ana has access now". The row then says what you gave them, or Declined.
If someone answered it elsewhere first, the row says "No longer waiting: answered elsewhere, or withdrawn". More on access is in Share an instruction.
What you are told about, and how
Under Tell me when, a switch for each kind:
| Switch | What it is about | At first |
|---|---|---|
| Someone suggests a change | To an instruction you maintain | On |
| Someone comments or mentions me | On | |
| A version is published | Of an instruction you follow | On |
| An agent starts reading | A new agent follows an instruction of yours | Off |
Under How:
| Switch | What it does | At first |
|---|---|---|
| In the studio | In your inbox in the editor | On |
| By email | To your email address, shown under the switch | On |
| A weekly digest | What changed across your workspaces, on Mondays | Off |
Signed in, your choices follow you to every device.
Appearance
Open Your account ▸ Appearance. At the top, a Preview shows a small instruction with buttons, a switch and two rules. It changes as you choose, so you see the result before you leave.
Appearance is kept in this browser and used at once. When you are signed in, it also follows you to your other devices.
Theme
Under Theme, choose System to follow your device, or keep it Light or Dark.
Your brand
Under Your brand:
- Colour. The colour of primary buttons, chosen chips and switches that are on. Pick one of the colours: Ink, Indigo, Blue, Teal, Green, Orange or Pink. Or choose Your colour to pick any colour.
- Corners. How round buttons, fields and cards are: Square, Rounded or Round.
- Type. The editor's typeface: Geist, System or Serif.
A colour has to keep the words on its buttons easy to read. If it doesn't, the page doesn't use it, and says why: "The words on its buttons would be hard to read (3.2:1, and they need 4.5:1). Pick a darker or a lighter colour." The listed colours always pass.
To go back to how the editor looked at first, choose Reset to the defaults.
The editor's language
Under Language on Appearance, choose the language of the editor itself. Same as my browser follows your browser's language. The editor reloads in the language you choose. Your instructions stay as you wrote them: only the editor's own words change.
The editor is translated into English, Ukrainian (Українська), Spanish (Español), French (Français) and Arabic (العربية). In Arabic, the editor runs from right to left. A word that isn't translated yet shows in English.
The Language on your Profile lists more languages. If you choose one the editor isn't translated into, the editor stays in English, and the assistant still starts in your language.
Show that you're here
On Your account ▸ Privacy, under What is shared, the switch Show that I'm here is about your face beside an instruction while you have it open. It is on at first. What else is on Privacy, and how to download or delete your data, is on Your data.
Check it worked
- Profile: the page says Saved, and your new name shows on your next comment.
- Appearance: the Preview and the editor change at once. Open the editor on another device where you are signed in: it looks the same.
- Language: the editor reloads in the language you chose.
If it doesn't work
| What you see | Why | What to do |
|---|---|---|
| "Your profile belongs to your account. Sign in to see it." | You are not signed in. | Choose Sign in. |
| "Your name can’t be empty: it is how people see you" | The name field was left empty. | Type a name. |
| "That isn't a colour. Pick one from the list, or choose your own." | The colour couldn't be read. | Pick a listed colour, or choose Your colour again. |
| "The words on its buttons would be hard to read …" | The colour is too close to the words on it. | Pick a darker or a lighter colour. |
| "Appearance didn't save" or "That setting didn't save" | The editor couldn't reach instruction.md. Your choice is used in this browser. | Check your connection, then choose it again. |
| Still stuck | Send us a request and choose My account. |
Questions
How do I change my email address?
You can't change it yourself. Your address is how you sign in, so only an administrator at instruction.md can change it. Send us a request and choose My account.
Can I use the editor in Ukrainian, French, Spanish or Arabic, or in dark mode?
Yes. Choose the language under Language on Your account ▸ Appearance. Arabic runs from right to left. For dark mode, choose Dark under Theme on the same page.
Where is my name shown?
On your comments, your suggestions and the versions you publish. Change it on Your account ▸ Profile.
Why do I still get notifications I turned off?
The switches keep your choices, but don't filter your inbox yet. Everything still comes to your inbox. See the note under Notifications.
Does my brand colour change what others see?
No. Appearance is yours alone. It follows you to your own devices, and nobody else sees it.