Working with a developerGuide
How to write a website project brief on one page
A brief has one job: to get a useful quote. Here is a one-page template to copy, a filled-in sample, and what to leave out.
On this page
A website project brief is one page that says what the business does, who the site is for and what a visitor should do. It also lists the pages you expect, what you already have, what must be kept, your constraints and who writes the copy. Leave the design and technical solution to the people quoting.
Every website design and development project with us starts with a written proposal. A brief like this is the fastest way to get one that fits, with fewer questions back and forth.
The one-page template
Copy these eight lines into a document and answer each in a sentence or two. Write "Not decided" where that is true.
- The business. What you sell, to whom, and where, in two sentences a stranger could repeat. Leave out the history.
- Who the site is for. The main visitor (a customer, a buyer, a candidate, a supplier), and the second if there is one.
- One thing to do. Call, book, order or request a quote, in one verb. A second action is allowed, but it ranks second.
- Pages we expect. A plain list, with a few words on each. A starting list, not a sitemap.
- What we have. Logo, colours, photos, product list, text, the domain, hosting and analytics, and who holds each login.
- What must be kept. Pages that bring enquiries, forms and where they send, addresses other sites link to, and tracking.
- Constraints. Dates with a reason, systems the site must work with, and who approves.
- Copy. Who writes it, and who provides images. Decide it now, because it shapes the timeline.
- 1. The business
- The bakery sells bread, cakes and festival boxes from one shop and takes orders by phone and WhatsApp.
- 2. Who the site is for
- Neighbours and office teams within reach of the shop who order cakes for occasions. Mostly on phones.
- 3. One thing to do
- Send a cake order enquiry.
- 4. Pages we expect
- Home, Menu, Cakes for occasions, Festival boxes, About, Contact and find us. Not final.
- 5. What we have
- Logo and colours. Photos of the cakes, not the breads. The menu as a PDF. The domain
bakery.example, registered in the owner's own account. Logins for the old site are with the person who built it. - 6. What must be kept
- The order enquiry form, which sends to a shared inbox, and the
/menu.pdfaddress printed on the packaging. - 7. Constraints
- Live before the festival season, when most orders arrive. Orders must still reach WhatsApp. The owner approves everything; the shop manager checks the menu.
- 8. Copy
- The bakery writes the menu and About text. The developer edits it. The bakery photographs the breads before the first milestone.
Sample only. The bakery is not a real business. Your brief says the same things in your own words, and nothing in it needs to be technical.
The lines that need the most thought
Lines 2 and 3 do the most work. Google's guidance on helpful, people-first content asks whether a site has a primary purpose and an intended audience. Your brief answers both before anyone designs a page.
"Make the site better" is not a visitor action. "Neighbours should send a cake order enquiry" is, and everything from the menu to the contact form can be judged by whether it helps.
Line 6 matters most when you already have a site. Google recommends building the list of addresses from several sources, not from memory, and our website migration checklist covers the rest of what to keep.
Line 5 is where projects stall quietly, because nobody knows who holds the logins. ICANN Lookup shows the domain's registrar. For the rest, see what to do first when your developer leaves, and get Search Console owner access before a developer goes.
Why one page is enough
The company reading your brief needs your facts and decisions, not a specification: working out the solution is the job it is quoting for. A longer document hides the three or four things that decide the project, and often locks in solutions chosen before anyone asked a question.
Who writes the copy, and why it decides the launch date
Copy is the words on every page. The build can run ahead of them on placeholder text, but a page cannot go live until real words and images are on it and approved. A bakery with a finished design and a Menu page with no menu waits on one document and the person who owns it.
That is why the brief names the writer. We agree it before we start, along with who provides images, which pages are in scope and what we need from you.
| Who writes it | What it means | What we need from you |
|---|---|---|
| You write it | The words are yours, in your voice. The site cannot go live until every page in scope has text. | A draft for each page by the agreed milestone, and one person who answers questions. |
| We write or edit it | Agreed in the proposal, page by page. We structure every page either way. | Facts, source material and quick answers, and your approval of each page. |
| You write, we edit | You supply drafts. We tighten them and fit them to the pages. | Complete drafts, not notes. |
Whichever you choose, you own your content. Photos affect the date as much as words, so name who supplies them in the same line.
Constraints, not a wish list
A constraint is a fact that limits the project and that the people quoting cannot guess. Constraints go in the brief; wishes belong in the conversation that follows, where they can be weighed against each other.
- Dates with a reason. "Before the festival season" is useful. "As soon as possible" is not.
- Systems it must work with. Payments, booking, accounting, email, WhatsApp or a customer list the business already uses.
- Who approves. One person who can decide, and anyone else who must see it first.
- Rules you work under. Languages the site needs, legal pages you already have, accessibility needs.
- What cannot change. A logo file, a brand colour, an address printed on packaging.
Keep each line to a fact. If the dates, systems or approvers are not settled, say so.
What to leave out: design solutions and long competitor lists
Describe the problem and leave the answer open. "A slider on the home page" is a solution. "A visitor on a phone should find the opening hours without scrolling" is a problem, and there may be a better answer than the one you pictured.
- Design instructions. Colours you must keep go under constraints. Anything else waits for the design stage.
- A platform you chose in advance. If your team must be able to edit the site in a particular tool, that is a constraint, so say it. Otherwise let the people quoting recommend one.
- Long competitor lists. Two or three sites you like, with one line each on why, tell us more than ten links.
- Feature lists. A long feature list invites a quote for every feature on it. The one thing a visitor should do is a better starting point.
What happens next
Send the page. We reply within 24 hours with a few questions or a time for a call, online or by phone, in your working hours. Then you get a written proposal: what is included, what is not, the timeline with milestones, what we need from you, and the price. Nothing starts until you have agreed to it in writing.
Larger or less defined projects start with Discovery & Scope instead. It is a short, paid engagement that ends in a written scope, a plan with milestones, an estimate and the risks. You own the document and can take it to anyone. How we work describes both.
Bring this to the call
- The filled-in page, with "Not decided" where that is true.
- The address of your current site, if you have one, and who holds its logins.
- Two or three sites you like, with a line on why.
- The pages that bring you the most enquiries today.
- The name of the person who approves.
Next step: fill in the eight lines, mark what isn't decided, and send us the page. We'll reply with questions or a time for a call.
Questions
How many pages do I need?
As many as your visitors need to decide, and no more. Start with the questions a customer asks before contacting you; the proposal then lists the pages in scope one by one.
Should I list my competitors?
Not at length. One clear sentence on how you want to be understood tells the people quoting more than ten links.
What if I don't know what I need?
Fill in what you can, mark the rest "Not decided" and describe the problem. If most lines stay open, Discovery & Scope is the usual first step.
Is a website brief the same as an RFP?
No. A request for proposal (RFP) is a formal document, usually from a larger organisation, asking several companies to answer in a set format. If you have to issue one, the eight lines make a good core for it.
Who owns the content on my website?
On our projects, you do, and the proposal says so. With anyone else, read the contract, because ownership of what is made for you depends on it. This is general information, not legal advice.
Sources
- Google Search Central: Creating helpful, reliable, people-first content Checked 16 Oct 2026
- Google Search Central: Site moves with URL changes Checked 16 Oct 2026
- Google Search Console Help: Managing owners, users, and permissions Checked 16 Oct 2026
- ICANN Lookup Checked 16 Oct 2026
Reviewed and edited by Online Scope before publishing. Something out of date? Tell us at info@onlinescope.in. How we write the Blog.