What Should the Terms of Reference for a Website Contain?
Developers need to understand exactly what changes the client wants on their website. The project manager is the one who communicates with the client, and it's their job to pass all of that information on to the team. How do you do this properly and avoid a game of "telephone"? That's what the terms of reference, or website specification, is for. This document presents information in language that everyone at a development company can understand, and it covers not only the key points but every small detail as well. So how do you write a specification that leaves the client satisfied with your work in the end?
A specification is not just a list of requirements. It's a document that governs the work between the client and the development company. It's how information gets from the client to developers, front-end developers, designers, SEO specialists, testers, content managers, social media specialists, copywriters, and others. A well-written specification makes a high-quality end result far more likely.

It doesn't matter whether the website is small or large. The document eliminates gaps between what the client expects and what the specialists working on the project deliver. This isn't a question of time or budget.
The first thing we consider when writing a specification is the size of the company that will build the project. If a team of five people understand each other perfectly, the document can skip the formalities. If several departments with several employees each are involved, formalities are essential. A large team can only be managed through a process, and a process requires formality. A specification can be longer or shorter depending on how complex the processes are.
What questions does a good website specification help answer?
- Is this interface suitable for further work?
- Can the team keep working with it, and how will it be used in later stages?
Before you start preparing the specification, discuss all open questions within the team. Each specialist will share their comments and suggest improvements. Budget constraints are taken into account as well. Every team member's goal is to do the best possible work within the given budget. Search for a company in the WordPress Development Agencies directory.
It's important to discuss the challenges that may come up not only for you but also for the client. The specialists' years of experience at the drafting stage will help smooth out any rough edges.
Why does the client need a specification?
What does the client gain from having a specification? How does it help when working with a web design agency?
- Protection for the client. Unfortunately, there are dishonest contractors out there. This document serves as proof of what the work was supposed to be if something completely different was delivered.
- A specification gives structure to the work, processes, and ideas. Sometimes the client doesn't have a clear idea of what changes their website needs. They express them vaguely, and their thoughts drift. A specification helps both sides understand each other correctly. Everything is laid out clearly in a single, structured document.
- Budget savings. Well-thought-out tasks prevent problems not only for the client but also for the agency's team.
Why does the contractor need a specification?
The document is just as important for the contractor as it is for the client. A well-written specification saves a lot of stress during website development.
- The contractor's safeguard. If, in the end, the client demands something that wasn't in the document, the contractor can always refer to the specification to prove that every agreed-upon item was delivered.
- Protecting work time. When every item is in the specification and the processes are described in detail, there are no unnecessary questions to slow the work down. Each team member clearly follows their own part and turns the client's ideas into reality.

How to write a website specification
The easiest way is to ask the client to fill out a brief. As a reminder, a brief is a list of questions that define the expected results. The client should explain why the site is being changed, what they expect from it, and what exactly they want to change to get the result.
Sometimes a brief can replace the specification if it's detailed, clear to both parties, and signed by both. The difference is that the brief reflects the team's vision, while the specification is the final document that contains your agreed adjustments in addition to the client's wishes.
When you first draft the specification, it won't be complete, because every specialist who works on the project will have questions and comments. The specification can be adjusted throughout the project. If the changes are significant, they are discussed with the client. Adjusting the specification is a normal and inevitable part of the process.
What should a specification include?
There is a set of standard questions the client answers before receiving the finished specification. Here they are (they can be expanded or changed):
- Company information.
- Target audience.
- Website goals.
- Analysis of the existing website.
- Preliminary site structure.
- Approximate page structure.
- Design and layout requirements.
- Available files.
- Minimum screen resolution and target devices.
- Whether a mobile version is needed.
- Sample set of modules.
- Admin panel capabilities.
- Payment gateway and shipping integrations.
- Integration with CRM, ERP, and other software.
- Questions from the developer.
- Additional requests.
What to keep in mind when working with a specification
As changes are made, the specification may be revised substantially. The contractor tries to improve certain steps to get a better result. Whenever the document changes, keep a list of those changes.
A specification helps manage disagreements between the client and the contractor. Even with a document based on the brief, the result may differ from what was expected. That's why you should monitor the interim stages and double-check finished elements to make sure the work is going according to the specification.


