Documentation

Website

Calculators

Set up product-connected catering, event, service, materials and meal calculators.

Calculators

Use a Calculator widget to help visitors choose products, plan quantities or estimate a service. It works with any company’s catalogue and does not change your product database.

Set up a calculator

  1. Add Calculator from the page editor’s widget picker.
  2. Choose a template and select Use template. This replaces the widget’s current settings; the page editor’s undo can restore them.
  3. Open Input setup and conditions. Change the example choices and review every price, capacity, unit and assumption. Business settings hold fixed values such as an hourly staff rate; visitors do not have to enter them.
  4. For a product selection, choose Live products or Live add-on group. Select a location and, if useful, a category or specific products. Leave specific products unchecked to follow the category automatically.
  5. Choose where each value comes from: the catalogue’s price, product kcal, product capacity, or a value you enter for each choice. Prices display in your company’s currency. Add-on prices use their price adjustment. Add-ons currently require manually entered nutrition values.
  6. Try different choices in Try the calculator, including small and large inputs, optional extras and missing values. Review the estimate note and next-action link.
  7. Check I have reviewed the values and rules. Enable this calculator for visitors, then save and follow the normal site publishing workflow. Templates remain disabled until reviewed.

All formulas in a template are already connected. Most setups only need the business’s own values, choice labels and product connections. Save a configured widget to the existing company library to reuse it on other pages.

Templates

TemplateIncluded calculations
CateringStandard and plant-based guest counts; packages and extras per guest; minimum food spend; a discount for additional guests above a threshold; rounded staffing; staff hours; delivery; service charge; optional additional tax; total and per guest.
EventsWhole tables and seats provided; rounded staffing; guest packages; minimum package spend; fixed extras; hourly venue hire; staff hours; service charge; optional additional tax; total and per guest.
Equipment hireItem quantity; duration; minimum billable days; fixed booking extras; hire charges; refundable deposit shown separately; upfront amount.
CleaningArea; bathrooms; service-level multiplier; optional tasks; staff hours; elapsed duration for multiple cleaners; minimum charge.
MaterialsArea and depth converted to volume; extra-material allowance; whole bags rounded up; material cost.
Meal nutritionMeal values; vegetables; multiple extras; net replacement adjustments; protein, carbs, fats, kcal and kJ. Nutrition figures start unknown.

Example prices and rates are illustrations, not industry recommendations. A linked product’s price must match the formula’s unit: for example, a per-person catering package differs from a platter serving several people. Product capacity means the existing people per unit value; enter a manual metric for litres, weight or another measure.

For catering sold by trays, add a value for servings per tray and calculate ceil(guests / trays.servings). Multiply that quantity by trays.price. The same pattern works for chairs, table linen, drink packages and equipment bundles. A separate selection or number input can hold the quantity for each different product group.

The catering template’s discount applies only to guests above its threshold, using the average package-and-extras price. Its service charge applies to food after the discount/minimum. The events template’s service charge applies to the guest package. Additional tax defaults to zero to avoid adding tax twice when catalogue prices already include it. Edit these rules to match your actual offer.

Custom inputs and rules

Inputs can be numbers, one choice, multiple choices, or yes/no. Set minimums, maximums, step sizes, starting choices and required selections. A numeric business setting is hidden from the visitor’s controls but remains part of the calculation.

Each selected choice contributes its configured values. Selecting several extras adds their values together. A blank numeric value means unknown, while an explicit zero means it contributes nothing. Unavailable products and incomplete required values cannot silently become a zero total.

Business rules compare input values before showing results. For example:

LeftRuleRightVisitor message
plant_guestsAt mostguestsPlant-based guests cannot exceed all guests.
guestsAt mostvenue.capacityThis venue cannot accommodate that many guests.
adults + childrenEqual toguestsGuest counts must add up to the total.

Custom results

Each result has a label, formula, display format and decimal precision. Results can be numbers, currency or percentages. Hide intermediate results when only the final answer is useful to visitors. Display rounding does not round intermediate values.

Use the input’s displayed formula key, a selected value such as package.price, or an earlier result key. extras.count counts selected options. Yes/no inputs are 1 or 0. The formula helper can append available references.

Supported operations are +, -, *, /, brackets, min, max, ceil, floor, round and abs. Percentages use 0–100: subtotal * tax_pct / 100. Formulas cannot run JavaScript, access other records, call external services or contain spreadsheet cell references. Use earlier results to break a long formula into readable steps.

Meal nutrition and generic stickers

A sticker can link to the calculator page using a QR code. Customers select their meal, sides and extras. Configure the meal’s included components consistently with its saved kcal value. If a base is already included, a replacement must contribute replacement minus included base; otherwise the calculator counts both. Negative adjustment values are supported.

Do not extract numbers from ordinary tags or descriptions: those labels may be incomplete or ambiguous. Enter verified protein, carbs and fat values for each standard portion. A product’s saved kcal can remain connected to the catalogue. Newly added products automatically appear when using a category, but need any missing manual values before they can produce complete results. Release checks identify missing values before publication.

What visitors can do

Visitors receive immediate results, can reset their choices and copy a plain-text summary. The optional next-action link can open your contact, catering, enquiry or ordering page. Add an Enquiry form beside the calculator if appropriate; customers can paste the summary into their enquiry.

Calculators provide estimates. They do not reserve tables, check date-specific stock or staffing, create orders, submit enquiries, issue binding quotes, or transfer the selected options into a checkout. Live prices reflect the catalogue when the page loads; reload to get later changes. Business settings and formulas are visible in the downloaded page, so do not put confidential costs, credentials or private data in them.

For predictable page size, each calculator supports up to 30 inputs, 16 results, 8 business rules, 12 numeric values per choice and 80 choices per selection. Large catalogues should use narrower categories or selected products. An unavailable connection shows a helpful message rather than a misleading total.

Conditional questions and options

Open an input and expand Show this input to add conditions. For an individual choice, expand the choice and use Offer this choice. These controls work for manual choices, connected products and add-on groups.

Choose an earlier input, a comparison and its value. Choice conditions can include or exclude selected options. Numeric conditions support equals, not equal, greater/less than, at least and at most. You can also compare a selected product's numeric values (such as capacity), the number of selected options, or a yes/no input. Combine up to eight conditions using All conditions match or Any condition matches.

Examples: show delivery details only when delivery is selected; offer a staffed catering package for at least 50 guests; show AV choices for an event package; restrict equipment accessories to compatible products; offer a meal's base replacements only when its product flags allow them.

Conditions must point to inputs above the current question. Move the controlling input earlier if needed; forward references, circular dependencies and removed choices are flagged for correction. Conditions do not need formulas or code.

When a selection becomes unavailable, it is removed. A single-choice input returns to an available configured starting choice, otherwise it asks the visitor to choose again. Hidden questions are excluded from totals and the visitor summary; their previous extras cannot remain in the calculation. Stored business settings keep their configured rate for when they become relevant again. Missing controlling values remain unknown, not free/zero estimates.

Under Choice behaviour and order, these controls work independently after conditions are applied:

  • Automatically choose when only one choice is available selects the sole available choice. Its values contribute to the calculation and it appears in the summary. This is opt-in because the choice can carry a cost. It works for single and multiple selections.
  • Hide input when one or no choices are available hides an unnecessary control. It does not select a choice or add a cost. Questions that still require an answer, or have an error, remain visible so visitors can resolve them.

Enable both to select and hide a sole choice. Existing calculators using the previous combined setting keep that behaviour until you edit the new controls.

Keep cross-input business rules for final validation where useful. Conditions guide the visitor before a choice is made; rules still check the resulting combination. Review all reachable choices in the preview before publishing.

Edit calculation values in a table

Calculation values brings starting values, business settings and per-choice numbers into editable tables. Each choice has a row; each value has a column with its unit. Filter by input or choice name to find a product quickly. All choices remain visible here even when visitor conditions hide them.

Manual cells update the calculator when you leave the cell or press Enter. Press Escape to discard a cell edit. Blank means unknown; enter zero explicitly for a zero contribution. Negative values are supported for replacement adjustments.

Catalogue columns show their live source and remain connected. Select Use editable values to copy the current column into manual values, then edit it. Future products will need their own values. To reconnect, select the live source again under Input setup and conditions → Value source.

Name values and formula references

Under an input’s Values to calculate with, expand Add value. Enter a label, formula reference and optional unit before selecting Create value. The reference is suggested from the label: “Protein” becomes meal.protein; “Servings per tray” becomes trays.servings_per_tray. You can replace the suggested name before creating the value.

Each reference uses 1–40 lowercase letters, numbers or underscores, beginning with a letter. References must be unique within the input. count is reserved for the selected-choice count. The input prefix, such as meal., is shown separately.

Existing values also have an editable Formula reference. Renaming moves saved choice values and updates result formulas, both sides of business rules, and input/choice conditions in this calculator. Other calculators are independent. Changing a display label alone keeps the existing reference stable. Invalid or conflicting references keep the existing settings and show an explanation.

Open the full widget editor

Select a widget in the page editor and choose Open editor in its settings or outline row. It opens the current widget in a new tab, with the usual Mavos header and sidebar and a wider, centred settings area. Keep the original page tab open.

Use Apply to page to copy changes back to the original page draft, where the normal undo, save and publish workflow applies. If the widget changed in the original tab, the editor asks you to reopen it instead of overwriting those changes. Save to library is available for widgets that are not already saved. Existing library widgets can be saved or copied separately. Saving a preset does not update every page that previously used it.

From Library, choose New widget, select its type and Open editor. Configure and preview it before saving it to the library. Undo restores recent edits within the open editor. A saved preset can also be opened directly from its library row.

Sort calculator choices

Open an input's Choice behaviour and order and choose Sort choices. Keep the catalogue/entered order, sort names A to Z or Z to A, sort any calculation value low to high or high to low, or choose Custom order. When sorting by value, choose the metric, such as price, protein or capacity. Unknown numbers stay last in either direction.

For custom order, use each choice's up/down buttons or position selector. The value table, choice settings and visitor selection use the same order. Conditions still filter which choices visitors can select. New catalogue products are appended alphabetically, while existing choices retain their custom order. Sorting changes presentation only; choice IDs, conditions and calculations remain connected.