• Home
  • Blog
  • What Should the Terms of Reference for a Website Contain?

What Should the Terms of Reference for a Website Contain?

July 22, 2022
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 communicates with the client and must pass all of that information on to the team without distortion, like a game of “telephone.” That's what the terms of reference, or website specification, is for. This document presents information in language that everyone on the team 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 the result?

A specification is not just a list of requirements. It's a document that governs the work between the client and the contractor, and a way to pass information 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 result more likely.

Why you need a website specification

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.

The first thing we consider when writing a specification is the size of the team. If a team of five people understand each other perfectly, the document can skip some of the formalities. If several departments with several employees each are involved, formalities are essential: a large team can only be managed through a process. A specification can be longer or shorter depending on how complex the processes are.

What questions does a good website specification help answer?

  1. Is it clear to the contractors what exactly needs to be done?
  2. Can the result be checked against the specification?

Before you start preparing the specification, discuss all open questions within the team. Each specialist will share their comments and suggest improvements. Also take the project's budget limits into account: every team member's goal is to do the best possible work within the given budget.

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 agency?
  • Protection against disputes. Unfortunately, there are dishonest contractors out there. The specification confirms what was agreed and lets you compare it with what was delivered.
  • Structure for the work, processes, and ideas. Sometimes the client doesn't have a clear idea of what changes their website needs, and their thoughts drift. A specification helps both sides understand each other correctly: everything is laid out in a single, structured document.
  • Budget savings. Well-thought-out tasks reduce the risk of problems for both the client and 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.
  • A basis for the agreed result. If, in the end, the client demands something that wasn't in the document, the contractor can refer to the specification to show that every agreed item was delivered.
  • Fewer clarifications mid-project. 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 knows their area of responsibility and turns the client's ideas into reality.

How to write a website specification

How to write a website specification


The easiest way is to ask the client to fill out a brief. A brief is a questionnaire the client completes: goals, audience, and wishes. The client explains 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 specification is the final document, which the contractor prepares based on the brief and agrees with the client: in addition to the client's wishes, it contains the agreed adjustments.


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):

  1. Company information.
  2. Target audience.
  3. Website goals.
  4. Analysis of the existing website.
  5. Preliminary site structure.
  6. Approximate page structure.
  7. Design and layout requirements.
  8. Available materials and files (logo, photos, copy).
  9. Minimum screen resolution and target devices.
  10. Whether a mobile version is needed.
  11. Required modules and features (catalog, filters, forms, customer account, and so on).
  12. Admin panel capabilities.
  13. Payment gateway and shipping integrations.
  14. Integration with CRM, ERP, and other software.
  15. Questions from the developer.
  16. 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, so monitor the interim stages and double-check finished elements to make sure the work is going according to the specification.

Need a specification for a website or online store? Describe your project and we'll help you put it together: get an estimate.

Stanislav Bakhariev
Author
Stanislav Bakhariev
SEO & Local Marketing Expert. In SEO since 2015: local SEO, Google Business Profile, technical audits and AI search visibility. Co-founder of Promodex, IT-Rating and MapStars.
Author page
Ready to build something remarkable?
Awards & recognition
1st place WEBAWARDS
Online store developers
2nd place WEBAWARDS
Magento CMS developers
1st place WEBAWARDS
Online store developers
5th place Clutch
Top small business web design companies
7th place Clutch
Top WordPress developers
2nd place Clutch
Top 30 web development companies
19th place Clutch
List of the top Wyoming web design companies
4th place Clutch
Top web designers in Casper
22nd place Clutch
Top web developers in Wyoming
4th place 99 Firms
40 Best web design companies
1st place Digital Agency Network
Best digital marketing agencies in Delaware
4th place UpCity
BigCommerce development companies
55th place UpCity
Ecommerce development companies
1st place UpCity
Website development companies
5th place OpenCart
OpenCart experts
20th place DESIGNRUSH
Top web design companies in the USA
5th place DESIGNRUSH
Top design firms in the USA
5th place Top Developers
Top 10+ OpenCart development companies