Website development

Website brief: what to include before development begins

How to write a useful website brief: goals, pages, functionality, content, integrations, timelines and acceptance criteria.

Website brief: what to include before development begins

Website projects often drift because expectations were never written down. A client imagines one homepage, the designer sketches another and the developer does not know a contact form must send data to a CRM. A clear website brief reduces these surprises without becoming a hundred-page technical manual.

Start with the business goal

Explain whether the site must generate enquiries, present a product catalogue, accept orders, support existing customers or build trust. State the primary action visitors should take. Then describe the main audience groups and the questions they need answered before they can act.

A manufacturer may need product filters, specifications and a request-for-quote workflow. A professional services company may need convincing credentials, case studies and simple contact options. The right corporate website follows the use case rather than fashion.

Define pages and functionality precisely

List the required sections and important page types. Describe anything beyond standard content: search, filtering, accounts, product imports or CRM integration. For each feature, write a short scenario explaining what the visitor does, what appears on screen and which data should be saved.

“An easy contact form” is not a testable requirement. Specify fields, validation, a clear success message, spam protection and notification delivery. If a CRM is involved, record which fields should be transferred and how failed submissions are handled.

Assign responsibility for content

Writing, photography, product specifications and translations frequently delay a launch. Identify who supplies each type of material and who approves it. If the agency must produce content, include that work in the scope and timeline instead of assuming it will appear later.

Agree who controls the domain and hosting, who signs off designs and what happens when requirements change. Clear ownership protects both the client and the development team.

Define acceptance criteria

A useful brief describes how completion will be checked: responsive layouts, working forms, accessible navigation, basic metadata, analytics, essential redirects, accounts and backups. Avoid promises of perfect benchmark scores under all test conditions.

Before development starts, confirm:

  • Business objectives and primary conversion actions.
  • Page inventory and functional workflows.
  • Content owners and approval deadlines.
  • Change control and acceptance checks.
  • Post-launch support responsibilities.

A good brief defines an outcome rather than prescribing every line of code. If the project is not yet clear, begin with a short discovery process and a website planning consultation.

Topics in this article

Planning a website or improvement project?

Tell us about your goals and we will discuss a practical scope of work.

Discuss a project ↗