Websites for Israeli businesses, in Hebrew and English, at a fixed price.See pricing →

What a website specification is and how to write one

A website specification is a document that describes what a website has to do before anyone starts designing or building it: who it is for, which pages it has, what goes on each page and which systems it connects to. A good specification lets you compare quotes like for like and prevents arguments mid-project about what was included.

GuideUpdated 8 min read

What a website specification is

A specification is the written plan for the website. It answers questions such as: what the site is for, who the customers visiting it are, which pages it needs, what a visitor can do on each page, and how you will know the site is working. It does not decide what the site looks like. That is the job of the design, which comes afterwards.

This guide explains what goes into one, and ends with a complete example for a small business website.

Who writes it? For a small business website, the studio or developer usually writes it after a conversation with the owner, and the owner approves it. On larger projects, with complex systems or several types of user, a separate specialist is sometimes hired. Either way, you bring the business knowledge: what you sell, to whom, and what customers need to know before they get in touch. The professional side turns that into a list of pages and requirements.

Why a specification saves money and arguments

Quotes you can compare

When several suppliers receive the same document, every quote covers the same work. Without a specification, a cheaper quote may simply include less.

Fewer changes halfway through

Changing the document takes a few minutes. The same change after a page has been designed and built means redoing work, and usually paying extra.

Content on time

When it is written down who supplies each text and photo, and by when, the site does not stall waiting for materials.

A clear definition of "done"

Every stage has a sign-off point. Both sides know when the work is finished and what counts as an extra.

Clear ownership

The specification states whose name the domain, hosting and accounts are registered in. That saves trouble on the day you want to change supplier.

What goes into a website specification

SectionWhat to write
Goals and audienceWhat the site has to achieve (enquiries, bookings, sales), who the customers are, where they come from and what they need to know before getting in touch.
Site structure and pagesA list of every page and how they connect: home page, a page for each service, about, FAQ, contact, accessibility statement and privacy policy.
Content for each pageWhat appears on each page and who supplies it: texts, photos, videos, testimonials. If the supplier writes the copy, how many rounds of revisions are included.
FunctionalityForms and where they are sent, appointment booking, online payment, a WhatsApp button, a CRM connection. For each one: exactly what happens when the visitor clicks.
IntegrationsExternal systems the site works with: calendar, card payments, invoicing, newsletters, customer management. Who opens the account and who grants access.
LanguagesHebrew only, or English and other languages too. Hebrew and English on the same site need a design that works both right to left and left to right.
AccessibilityAn explicit requirement to build to IS 5568 at level AA and to publish an accessibility statement. The legal background is covered in the guide to the website accessibility law.
SEOReadable URLs in Latin characters, a title and description for every page, and if there is an old site: a list of redirects from every old URL to its new one.
Analytics and conversionsGoogle Analytics 4 and Search Console, and which actions count as an enquiry: a form submission, a tap on the phone number, a tap on WhatsApp.
Hosting and domainWhere the site will be hosted, whose name the domain and hosting are in, and who receives admin access at the end of the project.
Timeline and approvalsStages with a sign-off point at each: structure and content, design, full site for review, launch. Who approves on the business side.

Replacing an old site? Redirects and SEO in the specification

If you already have a site that appears in Google, the specification has to cover the move to the new one. Google Search Central's guidance on site moves recommends redirecting each old URL to its matching new URL with a permanent server-side redirect (301 or 308), straight to the final destination. Do not send lots of old pages to the home page. Keep the redirects for as long as possible, generally at least a year.

In practice this is a table in the specification: a column of old URLs, a column of new URLs, and who checks that every redirect works after launch. Mark the pages that bring the most traffic and enquiries today, so their content makes it to the new site rather than getting lost.

The specification should also say which system the site will be built on. If you have not decided yet, read the guide on how to choose a content management system.

Sample website specification

Example only. The business is fictional, and the details are there to show what a complete specification for a small site looks like.
SectionExample: a fictional Pilates studio in Holon
The businessA reformer Pilates studio in Holon with two instructors, offering group and private sessions. The business is fictional.
GoalSign-ups for a trial class. Secondary goal: enquiries about private sessions.
AudienceResidents of Holon, Bat Yam and Rishon LeZion who arrive from Google searches, Instagram and friends' recommendations.
PagesHome (including an introduction to the instructors), reformer Pilates, private sessions, timetable, FAQ, contact, accessibility statement, privacy policy. Eight pages in total.
ContentThe web developer writes the texts after a conversation with the owner, with two rounds of revisions. Photos at the studio: the owner's responsibility, by a date set in the quote.
FunctionalityA trial-class form (name, phone, preferred time) sent to the studio's email. A fixed WhatsApp button on mobile. The timetable is embedded from the booking software the studio already uses.
PaymentNo online payment at this stage. Class passes are sold at the studio.
LanguagesHebrew only. English possibly in a second phase, so the design is planned to allow adding it.
AccessibilityIS 5568 at level AA, tested before launch, an accessibility statement page with a contact person.
SEOEnglish URLs, for example /reformer-pilates/. No old site, so no redirects. A title and description for every page.
AnalyticsGA4 and Search Console. An enquiry is a form submission, a tap on WhatsApp or a tap on the phone number.
Hosting and domainThe domain is registered in the owner's name and the hosting is in her account. Admin access is handed over to her at the end of the project.
ApprovalsStage 1: site structure and content. Stage 2: design of the home page and one inner page. Stage 3: full site for review. Stage 4: launch. Each stage is approved in writing.

How to write a specification in five steps

  1. 01

    Start with the goal

    Write in one sentence what the site has to deliver: enquiries, bookings or sales. Every other section follows from that.

  2. 02

    List pages and content

    A list of pages, and three or four lines for each: what is on it and who supplies the materials.

  3. 03

    Spell out actions and integrations

    Forms, bookings, payments, WhatsApp, CRM. For each one: what happens on click, and where the data goes.

  4. 04

    Set stages and owners

    Who approves each stage, what counts as "done", and whose name each account is in.

  5. 05

    Send it to suppliers

    The same document to every supplier. Questions and suggested changes go into the document itself, not just a phone call.

The specification in a project with us

When we build a business website, the project starts with a specification call: what the business sells, to whom, and what needs to happen on the site. From that call we write a quote listing what is included, a fixed price and a timeline. If you have already written a specification, write to us through the contact page and we will ask you for the document. Starting prices for each type of site are in the price list.

Tell us about your site

A written quote with a fixed price and timeline within one business day. No commitment.

What do you need?

FAQ

Did not find your answer? Write to us and we will reply within one business day.

Does a specification have to be a long document?

No. For a small site, one or two pages are enough, like the example in this guide. What matters is that every section is clear enough for two suppliers to understand it the same way.

What is the difference between a specification and a design?

The specification decides what is on the site and what it does. The design decides how it looks: colours, fonts and layout. It is better to approve the specification before design starts, because a change in content also changes the design.

Do I have to write the specification myself?

No. You bring the knowledge about the business and its customers, and the supplier can draft the document. Make sure you read it and approve it in writing before work begins.

What if the requirements change halfway through?

Update the document and ask the supplier to estimate the change before it is made. That way it is clear what is an extra and what was included from the start.

Should accessibility and SEO be in the specification?

Yes. If they are not written down, a quote may leave out accessibility testing or redirects from the old site, and you only find out after launch.

WhatsAppGet a quote