Yard Docs
Sign in
On this page

Account preferences

The two steps a new account is shown once, and where to change how Yard looks and what the agent reads when nothing is selected.

Updated November 1, 2026 ยท 3 min read

The first steps of a new account

After you sign up and confirm your email address, Yard shows two steps before the app. They come up once per account, in whatever browser you finish them, and lead on to the page you were going to (the organization you were invited to, or setting up your own).

  1. Choose how Yard looks: the theme and the text size.
  2. Choose what the agent reads when nothing is selected: in a workspace, and in a project.

Continue and Back move between the steps. Finish setup saves the second step and opens the app. Skip setup, on either step, opens the app without saving the second step: the agent then reads what is marked "the default" below. A theme or text size you chose on the first step stays, because it applies as you choose it.

Accounts that existed before these steps were added are not shown them. Everything in them can be changed later in Account settings, which you open from your avatar at the top right.

How Yard looks

Account settings, Appearance. These choices are kept in the browser you make them in, not on your account: another browser or device starts from the defaults.

  • Theme: System (the default) follows the light or dark setting of your device, Light is dark text on light surfaces, Dark is light text on dark grey surfaces. A browser that had one of the former "Just for fun" themes selected now shows Light, or Dark for Terminal.
  • Text size: Default is 16px text, as your browser sets it; Large makes everything an eighth larger, with 18px text. Your browser's zoom and font size settings work as well.

What the agent reads when nothing is selected

Account settings, Agent context. This is the context of a request you send in the chat without selecting blocks first. It is kept on your account, for every workspace you are in, and applies to the messages you send: someone else in the same chat has their own setting. A selection always wins over it.

On a workspace's docs and canvases, and on its other pages (files, monitors and so on):

  • Only what I select (the default): nothing but your message until you select blocks, docs or repositories.
  • The whole workspace: every block on its canvases and docs that you may open, and every repository connected to it. The agent gets the list of blocks with where each one's file is, and opens them as it needs them.

In a project:

  • The whole project (the default): the spec, the linked blocks and the project's files.
  • Only the spec and what I select: the project's spec, and nothing else until you select more.

An account that had chosen Only pinned blocks before canvas pins went now has Only what I select (in a project, Only the spec and what I select).

The line under the workspace chat's composer says which one applies: for example "Reads the whole workspace, until you select blocks" on a canvas. See chat.

The setting is not used where the context is fixed by the page: a stat's or a prototype's own chat, an investigation, a message sent together with a monitor or stats, and the turns that write a spec or carry it out. A project's chat also reads the whole project until the project is started, and while it waits for your answer to a question (those always read everything linked to the project).

Was this page useful?
Edit this page