How to write a technical specification for a website tender

A poorly written specification produces bids that can’t be compared, a portal that suits nobody and disputes over what was included. This guide is for procurement officers and managers in institutions, public utilities and donor-funded projects buying a website or portal.

5 min read

Public procurement in Bosnia and Herzegovina is governed by the Law on Public Procurement (Official Gazette of BiH 39/14, 59/22 and 50/24), and procedures run through the e-procurement system at ejn.gov.ba. The law sets the procedure, but the quality of what you receive depends mostly on the technical specification. This is the structure I recommend, written from the point of view of a supplier who has read many good and bad tender documents. The same principles apply to donor-funded projects with Terms of Reference.

Short answer

A good specification describes what the portal must enable citizens and staff to do, not which technology to use. It contains a list of pages and functions, requirements for accessibility, speed and security, ownership of the code and domain, maintenance, deadlines and measurable acceptance criteria.

Before writing: market check and real needs

The law provides for a preliminary market check before launching a procedure (Article 14a). Use it: talk to users of the current website, look at what citizens most often ask for by phone or at the counter, and compare portals of similar institutions. Ask several providers for an indicative estimate and document everything. That gives you a realistic estimated value and a specification that matches real needs.

  1. Goal and users — who the portal is for and what they should be able to do on it (report a fault, find documents, read notices, use e-services).
  2. Scope — list of pages and sections, number of languages, migration of existing content (how many pages, news items and documents).
  3. Functional requirements — what users and administrators must be able to do, described as tasks.
  4. Non-functional requirements — accessibility, speed, security, data protection, mobile display.
  5. Hosting and domain — who provides hosting, where data is stored, who the domain is registered to.
  6. Ownership and documentation — source code, logins, technical and user documentation.
  7. Training — number of people and format of editor training.
  8. Warranty and maintenance — warranty period, time to fix defects, optional maintenance after the warranty.
  9. Deadlines and phases — design, development, testing, migration, go-live.
  10. Acceptance criteria — how you will verify that what was agreed has been delivered.

Functional requirements: describe tasks, not technology

Instead of “the portal must run on platform X”, write what needs to happen:

  • “Authorised staff publish news, notices and documents without a developer’s help.”
  • “Citizens can report a fault with location and photo from a mobile phone.”
  • “Documents can be filtered by type and year and searched by title.”
  • “Works notices appear on the home page while the works last.”

Referring to a specific brand, product or origin restricts competition. If it is unavoidable, add “or equivalent” and describe what the equivalent must meet.

Non-functional requirements worth writing down

AreaExample of a measurable requirement
AccessibilityCompliance with WCAG 2.1 level AA, verified with a tool and a manual keyboard test
SpeedCore Web Vitals in the green on mobile for key pages
SecurityHTTPS on all pages, two-factor login for administrators, regular off-server backups
Data protectionForms collect only necessary data; privacy policy in line with the law
Mobile displayCorrect display from 320 px width, no horizontal scrolling
Search enginesTitles and descriptions for all pages, a sitemap, redirects from old URLs

More on accessibility and how to check it in website accessibility (WCAG).

Ownership: the most frequently missed item

The institution should receive the source code, all logins (domain, hosting, admin) and documentation, with no lock-in to a single supplier. The domain is registered to the institution. If this isn’t in the specification, three years later you may find that nobody but the original supplier can maintain the portal.

Acceptance criteria

Before signing the handover record, check that every function in the specification works, the speed and accessibility test results, that content was migrated and old URLs redirect to new ones, that editors were trained and that you received the code and all logins. State in the specification that delivery is complete only when all criteria are met.

Award criterion

The criterion can be the lowest price or the most economically advantageous tender. For web portals, lowest price often means the minimum interpretation of the specification. If you choose lowest price, secure quality through very precise technical requirements and acceptance criteria. Supplier qualification requirements should be proportionate to the contract value so they don’t exclude small, specialised suppliers without reason.

The most common mistakes

  • A specification copied from another institution, with functions you don’t need.
  • No information on the amount of content to migrate — bids then can’t be compared.
  • No deadline for fixing defects during the warranty period.
  • Hosting and domain “with the supplier”, without access for the institution.
  • No measurable requirements for speed and accessibility.

Note

This guide is a practical recommendation for the content of a technical specification and is not legal advice on running a procedure. For the procedure itself, rely on the Law on Public Procurement, its by-laws and the guidance of the Public Procurement Agency of Bosnia and Herzegovina.

Preparing a portal tender?

As a potential bidder I don’t write tender documents, but this guide and the example requirements are yours to use. See how I approach portals for institutions on the public sector page.

Public sector

Engimotive · Published October 28, 2026

FAQ

Frequently asked questions

Can the specification require a specific platform, such as WordPress?

Describing the solution through a specific product or brand restricts competition and can be grounds for a complaint. It’s better to describe functional requirements — for example that staff can publish news and documents themselves — and, where a product reference is unavoidable, to add “or equivalent”.

How do we estimate the contract value?

The law provides for a preliminary market check before a procedure is launched. You can ask several providers and independent experts for indicative offers or advice, provided the consultations are documented and do not distort competition.

What if something turns out to be missing from the specification after signing?

That’s exactly why the specification should include a list of deliverables, acceptance criteria and clearly defined change requests. Anything not described will rightly be treated by the supplier as additional work.

Contact

Have a project in mind? Let's talk.

Describe your idea in a few sentences. I'll reply personally within 24 hours on business days, with clear next steps.

Emailinfo@engimotive.com
LocationZenica, Bosnia and Herzegovina
Working modeRemote — Europe and worldwide

What happens next: a reply with a few questions → a short call → a fixed quote. No obligation.

Fields marked with * are required. I use your details only to reply to your inquiry. Privacy policy.