Recent chats
ASKGEEZ Q&A GUIDEWriting & communication

How do I write a form-completion guide that explains each field clearly?

Quick answer

Make a separate help-text entry for each field. State what information belongs there, whether it is optional if you can confirm that, any required format, and what to do if it does not apply. Add a short example only when it clarifies the expected response. Put guidance before or beside the field, keep it concise, and check official requirements with the form’s issuer.

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

How should I plan guidance for a form with lots of fields without creating a wall of instructions?

Geez

Follow the form’s order and make one entry per field, using its recognizable label. This helps readers match the guide to the form. Clear instructions should explain what information is expected, including for optional fields. [S1]

Use this copyable planning table, filling in only details you have confirmed:

Field label | What to enter | Required or optional? | Format or rule | If it does not apply | Example, if useful [Form label] | [Plain-language description] | [Confirmed status] | [Confirmed rule, or none] | [Issuer’s instruction, or check with issuer] | [Clearly marked example, or none]

The table is a planning aid, not a substitute for checking requirements. The issuing authority determines what the form requires.

Follow-up question

How do I explain what belongs in a field rather than just repeating its label?

Geez

Turn the label into a short, specific action. For example, if a form has separate fields labelled “Given name” and “Family name,” give each its own entry and explain what belongs in that field according to the issuer’s instructions. Do not assume from the labels alone whether a particular name format or additional detail is required. Separate labels can help clarify what information belongs in each field. [S1]

A useful test is: could someone unfamiliar with the process tell what information to look for? If not, add a plain-language description. Leave out background that does not help with that field. If the answer depends on official instructions, flag it for confirmation instead of guessing.

Follow-up question

What should I say about optional fields and fields that do not apply to someone?

Geez

Check the issuer’s instructions before calling a field required or optional, or telling readers what to enter when it does not apply. Those situations are not automatically the same: optional means the issuer permits leaving a field blank, while “does not apply” describes a reader’s circumstances. Explain the issuer’s actual instruction; do not assume that “N/A” or a blank is acceptable. [S1]

For example, a draft entry might look like this:

Field label: Previous address What to enter: The address requested by the form, once confirmed Required or optional?: Confirm with issuer If it does not apply: Use the issuer’s stated instruction; if unclear, check with the issuer

This example is a planning prompt, not a claim about what any particular form requires.

Follow-up question

When should I use examples, and how can I check the finished guide?

Geez

Use an example when it clarifies a format or distinction that might otherwise confuse readers. Mark it as an example, and verify any detail that could be read as an official rule. For instance, a date-format example can illustrate a confirmed format, but the correct format for a particular form must come from its issuer. [S1]

Place guidance before or beside the relevant field, break tasks into clear steps, and keep instructions concise. Examples can help clarify what to do; provide needed guidance up front rather than relying only on error messages. [S2]

Before sharing, compare each entry with the form and the issuer’s instructions. Keep unresolved questions visible rather than filling them with guesses. Ask someone unfamiliar with the form to use the guide to find the right field and understand the instruction.

A practical checklist

  • Use the form’s recognizable field labels and order.

  • Explain what information belongs in each field using plain language.

  • Verify required, optional, and format rules with the issuing authority.

  • Give confirmed guidance for inapplicable fields; otherwise direct readers to check with the issuer.

  • Mark examples clearly and include them only when they clarify something.

  • Place concise instructions before or beside the relevant field; flag unresolved questions.

A few more useful answers

Should I tell readers to enter “N/A” when a field does not apply?

Only if the issuing authority says to use that response. Otherwise, direct readers to the form’s instructions or the issuer rather than guessing.

Should every field have an example?

No. Use one when it clarifies a format or distinction, and verify any detail that might imply an official requirement.

What if the form’s label and instructions seem unclear?

Note what needs clarification and check with the issuing authority before stating a requirement. Do not resolve uncertainty by inventing a rule.

Sources

References used for this guide.

  1. [S1] Understanding Success Criterion 3.3.2: Labels or Instructions
    w3.org · Checked
  2. [S2] Cognitive Accessibility Design Pattern: Use Clear Step-by-step Instructions
    w3.org · Checked

YOUR QUESTION. YOUR DETAILS.

Let’s work through your situation.

Get a tailored answer or help with your next task. Starts at $1, with a quote before you pay.

Ask your own question
← Back to Geez at Work