Skip to content

Custom fields in a letter

Some email templates have special spots for extra details — like your companion's name. You fill those in by typing a small code anywhere in your letter. The code itself never shows up in the email; only the value you typed appears, in the right place in the design.

The format

%% KEY: value %%

For example, to set your companion's name:

%% COMPANION: Elder Smith %%

Type it on its own line, or in the middle of a sentence — it works anywhere in the letter body, and the code is removed before subscribers see the email.

Which fields can I use?

It depends on the email template your site is set to (chosen by the parent in Email Design). Today:

  • The Scrapbook template supports a COMPANION field — your companion's name (for example, %% COMPANION: Elder Smith %%).
  • The other templates don't use custom fields right now, so a code you type is simply removed and nothing extra is shown.

Email help@ to see your template's fields

Send a short email to help@<your-domain>. If your current template supports any custom fields, the reply lists each one with an example you can copy.

Good to know

  • Keys aren't case-sensitive. %% companion: … %% and %% COMPANION: … %% mean the same thing.
  • If you type the same field twice, the last one wins.
  • A malformed code (missing the closing %%, for instance) is just left out — it won't break your letter.

See also: What you can do by email.