Plan your content for a new page

Before you start, try to answer these questions:

  • The primary audience: who is this page for?
  • Key information: what are they trying to do or find?
  • Call-to-action: what should they do after reading?

A page should answer one main question. If you can’t describe the page job in one sentence, your content may be better split into a web area (a folder in Cascade) with multiple related pages instead of one long page.

  • Create a simple outline using bullet points and hierarchy.
  • Aim for 3–6 main sections.
  • Use headings that a visitor can understand quickly.

Now write your content into the outline (or paste it over from the old page).

Write for skimmers:

  • Put the most important info first (don’t build up to the point).
  • Use clear headings that explain the content (not vague ones like “More information”).
  • Keep paragraphs short: 1 idea per paragraph, 2–4 lines max.
  • Prefer lists over long sentences when you’re describing steps, requirements, or options.
  • Use plain language and active voice (“Submit the form” vs. “The form should be submitted”).

Check what supporting assets you have (or need):

  • Images: Do they add meaning, context, or clarity?
  • Video: Is it essential to understanding or instruction?
  • Files: Are they current, correctly named, and truly needed?
  • Links: Which are the “top tasks” that deserve prominence?
If you have more than a few important links, consider using a CTA Links component.

Decide which parts of your outline work best as their own components.

Use components when content needs to be easier to scan, click, or digest. If a section feels “heavy” or cluttered in plain text, it usually needs a component.

Good matches

 

Browse components    Add a component (steps)