How-to guidesView as Markdown ↗

How to offer options on a proposal

In plain terms

Send one quote with a few choices, like monthly or quarterly visits. Your client ticks the one they want and signs online. Only the choice they ticked gets booked, at the price you quoted for it.

Set the proposal to choose-one, give each alternative's lines an option key and a label (A — Monthly, B — Quarterly), and send it. The PDF and the signing page show each option with its own price and no combined total. The client ticks one option and signs; only that option and any lines included with every option become contract service lines.

At a glance

Who it's for:
Business owners and the people who run the office

To offer options on a proposal in biloh, set the proposal's selection mode to choose-one, put each alternative's lines under its own option, and send it as usual. The client sees each option with its own price, ticks one on the signing page, and signs. Only the option they ticked — plus any lines you marked as included with every option — becomes contract service lines. You can do every step by chat or in the app.

When should I offer options instead of separate proposals?

When the client is choosing one of a few ways to buy the same thing: a window clean monthly at $110, quarterly at $160 or every six months at $240. One proposal with three options keeps the decision in one document and one signature, and nobody has to withdraw the two quotes the client did not pick.

Offer options only for alternatives. If the client should get several services together, that is an ordinary proposal where every line is part of the deal.

1. Set the proposal to choose-one

Create the proposal with create_proposal and pass selection_mode: "choose_one", or switch a draft with update_proposal. Every proposal starts in all mode, where every line is part of the deal — exactly as before options existed.

You can mark one option as recommended with recommended_option_key. The recommended option carries a badge on the PDF and the signing page, but it is never ticked for the client — they always make the choice themselves.

2. Put each alternative under an option

Add each line with add_proposal_line and give it an option_key (a short key such as A, B, C) and an option_label the client will read (Monthly, Quarterly, 6-monthly). Lines that share a key form one option; an option can have more than one line.

A line with no option key is a common line: it is included whichever option the client picks. Use it for something like a one-off initial deep clean. On the documents it appears under Included with every option.

To move a line back to common, call update_proposal_line with option_key: null.

By chat, an assistant can do steps 1 and 2 in one call: set_proposal_options takes the options (each with its key, label and lines), any common lines and the recommended option, and either builds all of it or changes nothing.

3. Check the figures before you send

preview_proposal_investment shows each option's figures — per visit, visits per year and the annual amount — and no combined total. Each option's figures are worked out exactly the way a whole proposal's figures are, over that option's lines only. When the proposal has common lines and shows its annual total, each option also shows its first year including the common lines.

4. Send it

Send it the usual way with propose_send_proposal — see how to send a proposal. Before anything is staged, the send checks the options and stops with a plain reason if:

  • there are fewer than two options (choose_one_needs_two_options),
  • an option has no label (option_label_required),
  • the lines of one option carry different labels (option_label_conflict),
  • there are more options than your business allows (too_many_options),
  • the recommended option is not one of the options (unknown_recommended_option).

5. The client ticks one option and signs

On the signing page the client sees Choose your option: one card per option with its price, none ticked. The totals stay empty until they tick one, then show the figures for that option plus the common lines. The I Accept This Agreement button stays disabled until an option is ticked.

If you record an acceptance yourself — for example the client accepted on the phone — pass the option with record_proposal_acceptance (selected_option_key: "B"). Without a choice on a choose-one proposal the acceptance is refused (selected_option_required) and nothing is written.

What happens after the client signs?

  • The chosen option's lines and the common lines become contract service lines, at the prices you quoted. The other options are kept on the proposal for the record, marked not selected, and never create a service line, a job or an invoice.
  • The signed agreement PDF and both acceptance emails name the choice: Option selected: B — Quarterly.
  • The client portal's agreements, the welcome page and the services list show only the deal they chose.

Can I change the wording or the number of options?

Yes, per business, in settings: the note printed above the options (finance.proposals.options.client_note), the recommended badge's wording (finance.proposals.options.recommended_label) and the most options a proposal may offer (finance.proposals.options.max_options, six by default).

Offering options works on every plan.

Under the hood

Source files this page is checked against:

  • lib/proposals/options.ts
  • app/api/proposals/accept/route.ts
  • app/proposals/accept/[token]/page.tsx

Raw markdown: /docs-md/how-to/offer-options-on-a-proposal

Last updated 2026-11-16