Specroot Waitlist open

Vision and scope document template

A vision and scope document says why a software project exists and where it stops: the business problem, objectives you can measure, a vision statement, the major features, and which of them go into the first release, which wait for later and which are not planned at all. It is written before the detailed requirements, so that each of them — and each request that comes later — can be checked against it. Below are its structure, a template, a filled-in example for a customer portal, how to write the vision statement and the scope, and how it differs from a BRD, a project charter and a scope statement.

Without a vision document, the chances are high that different stakeholders/departments will try to steer the development in their own direction, with the developers getting caught in the middle with a bunch of conflicting requirements.

— Software Engineering Stack Exchange, 2017

What is a vision and scope document?

Aspect Vision and scope document
Answers Why the product is built, what success looks like, and where the scope ends, release by release
Written by A business analyst or product manager, with the sponsor
Approved by The sponsor, and the people who fund or lead the work
Written At the start, often in a discovery phase, before the detailed requirements
Leaves out Screens, rules, data and acceptance criteria — those go in the functional specification or the SRS

The template this page follows is Karl Wiegers’, a free download from softwarereqs.com, the site of his book Software Requirements Essentials. It opens with the business requirements, which “provide the foundation and reference for all detailed requirements development”. One commenter, recommending it to someone who asked for a business requirements template: “It’s a significant artifact I have used for more than 11 years” (r/businessanalysis, 2024).

The document combines two things that are often written apart: the business case — the problem, the objectives, how success is measured — and the scope that follows from it. One answer on Project Management Stack Exchange describes it as a document that “defines the business case for the project in nontechnical language. It represents a high level overview of requirements, features, and proposed solutions” (Project Management Stack Exchange, 2011).

Vision and scope document structure

Wiegers’ template has three parts:

Section What goes in it
1. Business requirements
Background How things work today, and why the product is needed
Business problem or opportunity The problem being solved, and what happens if it is not
Business objectives What the business gains, in numbers
Success metrics How you will know the objectives were met
Vision statement A short statement of what the product is, for whom, and why
Business risks What could stop the product paying off, and what you will do about it
Assumptions and dependencies What is taken as true; what the project relies on
2. Scope and limitations
Major features A numbered list, so later requirements can point back to it
Scope of the initial release Which features come first
Scope of subsequent releases Which features wait
Limitations and exclusions What someone might expect, but will not get
3. Business context
Stakeholder profiles Who is affected, what they want, what worries them
Project priorities What is fixed, what drives the project, and what can give
Deployment considerations What has to be ready for launch: access, data, training

Vision and scope document template

Copy it into a document. Square brackets are yours to fill in; the section numbers follow Wiegers’ template.

VISION AND SCOPE DOCUMENT
Project:   [name]
Version:   [x.y], [date]
Sponsor:   [name, role]
Author:    [name, role]

1. BUSINESS REQUIREMENTS

1.1 Background
[How the work is done today, and what
led to this product]

1.2 Business problem or opportunity
Situation:    [the context today]
Problem:      [what goes wrong]
Implication:  [what happens if it is
              not solved]
Benefit:      [the value of solving it]
Vision:       [the future, once solved]

1.3 Business objectives
BO-[n]  [objective, with a number and
        a date]

1.4 Success metrics
[measure]: from [today] to [target]
by [date]

1.5 Vision statement
For [target users], who [need or
opportunity], [product name] is a
[product category] that [key benefit].
Unlike [the current way or the main
alternative], it [main difference].

1.6 Business risks
R[n]  [risk]
      Mitigation:  [what you will do]

1.7 Assumptions and dependencies
- [taken as true; owner, date]
- [what the project relies on]

2. SCOPE AND LIMITATIONS

2.1 Major features
F[n]  [feature]

2.2 Scope of the first release
[features, and the release date]

2.3 Scope of later releases
[release]: [features]

2.4 Limitations and exclusions
- [what someone might expect, but
  will not get]

3. BUSINESS CONTEXT

3.1 Stakeholder profiles
[stakeholder]: [wants], [concern]

3.2 Project priorities
Driver:       [the top objective]
Constraints:  [the limits]
Can give:     [what can be traded]

3.3 Deployment considerations
[access, data, training, support]

APPROVED BY
[name, role]  [version]  [date]

Vision and scope document example

The customer portal from the other templates on this site, where customers see and pay their company’s invoices. The objectives and metrics are the ones in the BRD example: a team that writes a vision and scope document keeps its business requirements there, instead of in a separate BRD.

VISION AND SCOPE DOCUMENT
Project:   Customer portal
Version:   1.0, 14 January
Sponsor:   Finance director

1. BUSINESS REQUIREMENTS

1.1 Background
Invoices go out as email attachments.
Customers ask about them by phone,
about 900 calls a month, and pay by
bank transfer, on average 41 days
after the invoice.

1.2 Business problem
Situation:    only the accounts team
              can see whether an
              invoice is paid
Problem:      customers call to ask,
              and pay late
Implication:  more calls each year;
              cash arrives six weeks
              after the work
Benefit:      fewer calls; invoices
              paid sooner
Vision:       customers see every
              invoice and pay it the
              day it arrives

1.3 Business objectives
BO-1  Cut the calls to the service
      desk about invoices by half
      within six months of launch
BO-2  Get invoices paid sooner

1.4 Success metrics
Invoice calls to the service desk:
from 900 a month to 450 by month six
Average days from invoice to payment:
from 41 to 30 by month six

1.5 Vision statement
For the billing staff of business
customers, who need to know what they
owe and pay it without a phone call,
the customer portal is a self-service
website that shows every invoice with
its status and takes payment by card.
Unlike calls and bank transfers, it
lets a customer settle an invoice the
day it arrives.

1.6 Business risks
R1  Customers keep paying by bank
    transfer
    Mitigation:  the payment reminder
    links to the invoice in the portal
R2  The payment provider's approval
    takes longer than planned
    Mitigation:  apply in week one

1.7 Assumptions and dependencies
- The payment provider account is
  open by 15 February
- Invoices come from the accounting
  system's daily export
2. SCOPE AND LIMITATIONS

2.1 Major features
F1  Sign-in for customers' staff
F2  Invoice list, status and PDF
F3  Paying an open invoice by card
F4  Email receipts and a payment
    reminder
F5  Saved cards

2.2 Scope of the first release
Phase 1, live by the end of May:
F1 to F4

2.3 Scope of later releases
Phase 2: F5, if phase 1 shows that
customers want it

2.4 Limitations and exclusions
- Consumer customers
- Paying part of an invoice
- Languages other than English
- A mobile app
- Changes to the accounting system

The business context is easier to read as tables. Stakeholder profiles:

Stakeholder Wants Concern
Finance director (sponsor) Invoices paid sooner (BO-2) Customers who will not change how they pay
Service desk lead Fewer invoice calls (BO-1) Calls about the portal itself
Customers’ billing staff To pay without a bank transfer Who in their company is allowed to pay
Customers’ other staff To see invoices and their status —
Accounts team Fewer payments to match by hand Payments that do not match an invoice

Project priorities, in the template’s terms of drivers, constraints and degrees of freedom:

Dimension Type For the portal
Features Driver F1 to F4 in phase 1
Schedule Constraint Live by the end of May
Quality Constraint Card data never stored by the portal
Cost Degree of freedom Up to 10% over budget without a new approval

Deployment considerations: customers’ staff use the portal from their own offices, with nothing to install; two years of invoices are loaded before launch; the accounts team is trained before go-live.

Two concerns in the stakeholder table turned into requirements later. “Who is allowed to pay” became the business rule that only the Billing role can pay (RULE-07 in the functional specification); “payments that do not match an invoice” came back as the part payments change.

How to write the vision statement

Wiegers’ instruction: “Write a concise vision statement that summarizes the purpose and intent of the new product and describes what the world will be like when it includes the product.” His template gives a keyword format for it, filled in here for the portal:

Keyword What goes in it Customer portal
For The target customer The billing staff of business customers
Who The need or opportunity Need to know what they owe and pay it without a phone call
The The product name Customer portal
Is The product category A self-service website
That The key benefit Shows every invoice with its status and takes payment by card
Unlike The current way, or the main alternative Calls and bank transfers
Our product The main difference Lets a customer settle an invoice the day it arrives

The format makes you name a user and a need before a feature, and say what the product replaces. One way to find the words is to ask the stakeholders to describe the future. One commenter, suggesting how to run a requirements workshop, starts with a “futurespective”: “Explain that it’s now 6 months after the new system went live and everything went perfectly! Get people to describe what the world looks like” (r/businessanalysis, 2026).

How to write the scope

  1. Number the major features. “Specific user requirements and functional requirements developed later may be traced back to these features,” as Wiegers’ template puts it. In the portal, F3 (paying by card) leads to FR-014, NFR-007 and RULE-07; F4 to FR-015 and FR-016.
  2. Choose the first release by the objectives. Phase 1 holds what moves BO-1 and BO-2: seeing invoices and paying them. Saved cards help returning customers, but are not needed to get invoices paid sooner, so they wait. Wiegers’ warning: “Avoid the temptation to include every possible feature that any potential customer category might conceivably want some day.”
  3. Put later releases in writing. A feature that waits is not a feature refused. Writing it under a later release stops the same discussion from starting again; the MoSCoW method calls these “Won’t have this time”.
  4. List the exclusions with the stakeholders. Whatever someone might expect: the features of the old system, other languages, other devices, changes to neighbouring systems. The scope statement page has places to look.
  5. Write down what can give. If the schedule is fixed and the features drive the project, say so, and say what can be traded when they collide.

How to write a vision and scope document

  1. Start with the sponsor and the problem. Wiegers lists where business requirements come from: senior management, “an executive sponsor, a project visionary, product owner, product manager, the marketing department, or other stakeholders who have a clear sense of why the project is being undertaken”.
  2. Write the objectives with numbers and dates. They decide the scope later. One commenter’s rule: “anything that doesn’t contribute to the business outcome being delivered is additional scope” (r/businessanalysis, 2022).
  3. Write the vision statement in a few sentences that the sponsor and the users would both recognise.
  4. List the major features, then split them by release, and write the exclusions.
  5. Profile the stakeholders, including the ones who will not use the product but are affected by it — here, the accounts team. The template’s reason: “to reduce the likelihood of unexpected requirements surfacing later”.
  6. Review it with the people who fund and lead the work, then approve one version. The requirements review checklist has checks that apply to business requirements too.
  7. Share it widely. The accepted answer to “Who should see the Vision and Scope document?”: “both vision and scope (in your case both in the same document) should be distributed as broadly as possible” (Project Management Stack Exchange, 2011). Clients should see it too, the answer goes on, “since they’re basically buying the vision and the scope”.

Using the vision and scope document when requests arrive

The document earns its keep after it is approved. Wiegers’ template is blunt about what it is for: “Proposed requirements that are out of scope for the envisioned product must be rejected, unless they are so beneficial that the scope should be enlarged to accommodate them (with accompanying changes in budget, schedule, and/or resources).”

In the portal, each request that arrived after approval could be checked against version 1.0:

Request Checked against Outcome
A blog on the portal (CR-6) Serves neither BO-1 nor BO-2 Declined
Push notifications (CR-8) Not a major feature; would move the phase 1 date Phase 2
Invoices in French (CR-9) On the exclusions list Change request, phase 2
Paying part of an invoice (CR-10) On the exclusions list, but large invoices stayed on bank transfer, against BO-2 Scope enlarged by change request

The last row is the exception Wiegers allows for: the request served an objective, so the scope grew, with its own cost and dates in a change request, and the vision and scope document got a new version that moved part payments from the exclusions to phase 2. One answer on Stack Exchange puts the everyday use plainly: with a vision document, “it is easier to say ‘this vision document is the direction that all stakeholders agreed upon and your new requirements deviate from that. We can’t take them into consideration until a new vision is agreed upon.’” (Stack Exchange).

Vision and scope document vs BRD, project charter and scope statement

Document Main question Written
Vision and scope document Why build it, and where does it stop, release by release Before the detailed requirements
BRD What the business needs, one requirement at a time Before the functional specification
Project charter Who authorizes the project, and with what authority When the project starts
Scope statement What the project delivers, and how it is accepted Before or with the statement of work
PRD What a product or feature does for its users Per product or release

Vision and scope vs BRD. They hold the same business requirements. Wiegers, on where he keeps them: “I like to document business requirements in a vision and scope document or a project charter” (Jama Software). A BRD lists them one by one, with IDs, priorities and sources; a vision and scope document adds the vision statement and splits the scope by release. Write one or the other, not both.

Vision and scope vs project charter. One answer to “What is the difference between Vision and Scope Document and a Project Charter?”, a question viewed over 11,000 times, puts it in a line: “Charter baselines the project. Vision baselines the scope” (Project Management Stack Exchange, 2011). Another: the charter is “a signed document by the sponsor authorizing the project manager and the team to start working. Vision and scope documents are just vision and scope; they can exist prior to the project” (Project Management Stack Exchange).

Vision and scope vs scope statement. The vision and scope document sets the product scope: which features, in which release. The scope statement sets the project scope: what is delivered — software, documents, training — and how each delivery is accepted. On a client project the scope statement usually comes after the vision and scope document and points to it; the statement of work then adds the price and terms.

Vision document, product vision, vision and scope

The names overlap. The Rational Unified Process has a vision document of its own; one commenter recommends it for “putting the user front and center, and ensuring that you’re building a system that people actually want and have a realistic business case” (Hacker News, 2020). Some product teams write a product vision statement and keep the scope in a roadmap. Whatever the name, the useful parts are the same: an objective you can measure, and a written line between what is in this release, what is later and what is not planned.

A vision and scope document for a small project

It does not need to be long. One commenter’s version for a small project is three sentences: “This project is a (short description) targeted at (accountants / small business / boy scouts). It solves this problem that the target market has: (pain point). Its main features are (what makes it a good solution / what differentiates it from the alternatives)” (Hacker News, 2015). Another, working alone, writes the full list of features first, then cuts it: “Reduce the number of features to minimum required for MVP and make a to-do list for MVP” (Hacker News, 2012) — the vision, then the scope of the first release.

Even for a team of one, an answer on Stack Exchange calls the vision document “a reference point, something you can look back to and determine whether or not your efforts are going to the right place” (Stack Exchange, 2017).

Where Specroot fits

This is the problem Specroot works on: the objectives and the scope agreed at the start kept linked to the requirements written from them, so that a request can be checked against the objective it serves and the release it belongs to. Specroot for agencies and consultancies.

  • Business requirements document (BRD) template — A free business requirements document (BRD) template for software projects, a filled-in example, business vs functional requirements, and BRD vs FRD, SRS, PRD.
  • Project scope statement template — A project scope statement template for software projects, a filled-in example, in scope vs out of scope, and scope statement vs project charter, SOW and WBS.
  • Product requirements document (PRD) template — A free PRD template with a filled-in example, a prd.md version for Claude Code and other AI coding agents, and how a PRD differs from a BRD and a spec.
What Specroot is