Search Website
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?
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
- Top task of the page: CTA Block
- Lots of links: CTA Links
- FAQ / policies / long details: Accordions
- Multiple related topics: Columns - 2-4 columns (each topic gets a clear title + short summary)
- People/contact lists: Staff listing
- Media: video or gallery