Write your own text into Simpro with scripts and booking placeholders
A script is text you write, with the booking's answers dropped in as placeholders. Each script is sent to one place in Simpro and prints after the ticked fields of that block on Simpro Notes.
Before you start
- Scripts need a Service booking form subscription. Without one the page opens with "Want to add your own text to Simpro?", and a save is refused with "Could not save scripts. A subscription is required."
- A script only prints when the block it goes to is switched on under Simpro Notes and has Scripts ticked there. The Printing column on this page tells you which of those is missing.
Step by step
- Open your form from Forms. On the Settings tab, open Scripts under Form responses.
- Click Add script. It opens as "New script", set to Project description and Every booking.
- Type a Script name. It only identifies the script in the list.
- Under Goes to, pick where it prints.
- Under Applies when, pick Every booking, A service is selected, An option is selected or A variation is selected. For the last three, choose what to wait for under Which one. You can choose several.
- Write the text in Script. Click a placeholder on the right to put it in at the cursor. HTML switches the editor to the raw HTML and Editor switches back.
- Click Done, then Save. The page says "Scripts updated."
Edit and Close open and close a row, and Delete removes one after a "Confirm delete" prompt. Nothing is saved until you click Save. If you leave with unsaved changes, "Unsaved scripts" asks whether to Leave without saving or Stay on the page.
The list is the order the scripts print in, and a new script goes at the bottom. Scripts for the same block are separated by a blank line.
Applies when only offers the choices the form has something for. A form with no services does not offer A service is selected, and the same goes for options and variations. Changing Applies when clears the choices under Which one.
Where a script goes
| Goes to | Prints in |
|---|---|
| Project description | The Job description or Quote description block, so the Simpro Description |
| Project notes | The Job notes or Quote notes block, so the Simpro Notes |
| Schedule notes | The Schedule notes block, so the Notes on the schedule entry |
| Cost centre description, Cost centre notes | Offered here, but see "A cost centre script never prints" below |
Placeholders
Write a placeholder as {{name}}. Spaces inside the braces are allowed. These are all of them:
| Placeholder | Fills in |
|---|---|
{{service}} |
The service name |
{{options}} |
The selected options and variations, as "Option: Variation" separated by commas |
{{price.total}} |
The quoted total, with your form's currency symbol |
{{date}} |
The booking date, such as Monday, 5 October 2026 |
{{time}} |
The slot, such as 09:00 - 10:00 |
{{customer.name}} |
First name and last name |
{{customer.company}} |
Company name |
{{customer.email}} |
Email address |
{{customer.phone}} |
Phone |
{{customer.mobile}} |
Mobile |
{{site.contact}} |
The site contact's first and last name |
{{site.contactphone}} |
The site contact's mobile |
{{site.name}} |
Site name |
{{site.address}} |
Site address |
{{site.city}} |
Site city |
{{site.state}} |
Site state |
{{site.postcode}} |
Site post code |
{{job.name}} |
The job name, or the quote name on a quote form |
{{job.description}} |
The description the customer wrote |
{{job.ordernumber}} |
The order number |
Each Simpro custom field that is switched on for the job, site or customer on this form is also a placeholder, written with its label, for example {{Gate code}}. The label has to match exactly, including capital letters. Only custom fields that are switched on and have a label are listed.
A line with no answer is dropped
Scripts are worked out one line at a time, and a line ends at a paragraph or a line break. A line that holds a placeholder the booking has no answer for is left out whole, so "Is the unit tenanted? {{Tenanted}}" never reaches Simpro with a blank after it. A placeholder name that matches nothing in the list counts as no answer. Lines with no placeholder are always kept. Empty lines at the end are trimmed, and a script that comes out empty writes nothing.
{{date}} and {{time}} have no answer on a callback, or when the customer chose to organise the date later.
When it goes wrong
The Printing column says No
The column gives the reason under the badge:
- "Project description is turned off", or the same for another block. The switch for that block is off on Simpro Notes.
- "Project description has Scripts off". Scripts is not ticked under Include on that block.
- "Nothing selected to wait for". Applies when is set to a service, option or variation and Which one is empty. Nothing prints for that script.
A cost centre script never prints
The Simpro Notes page has no switch for the two cost centre blocks, so a script aimed at one only prints on a form where that block was already switched on. Send the script to Project description or Project notes instead.
A script is missing in Simpro
- The booking was not for the service, option or variation the script waits for.
- Every line had a placeholder with no answer.
- The script has no text.
- A callback, an organise-later booking or an outside region booking has no schedule, so a script aimed at Schedule notes has nothing to print into. See Simpro Notes.
A line is missing
The placeholder is spelled differently from the list or from the custom field's label, so it has no answer and the whole line goes. Insert placeholders from the list on the right of the editor.