Skip to content

Custom Forms Guides

How Custom Fields work in Custom Forms

3 min read Updated 19 Nov 2026

How to

Custom Fields let you record extra details on a job that Ascora doesn't have a field for, such as who signed off a project. A Custom Form can print those details, and the job's standard fields, in its PDF. You do this by typing field codes into the form's document template. Custom Fields can be added to other records too, such as customers, quotes, purchase orders and invoices.

Watch the video guide

Custom Forms - Adding Images in Ascora's Training Videos shows how to work with Custom Form templates. You need to be signed in to Ascora to watch it.

Before you start

  • Create the Custom Field first, in Administration > Customisation > Custom Fields. See How to add a Custom Field.
  • You need Microsoft Word, or another editor that saves .docx files, to change the document template.

How to write field codes

  • Every field code sits in curly brackets.
  • Standard fields are written with no spaces, for example {JobNumber} for the Job Number, {JobName} for the Job Name, {JobSummary} for the Job Description and {JobWorkUndertaken} for Work Undertaken.
  • Custom Fields are written exactly as the field is named, spaces included. A Custom Field called Project Sign Off By is written {Project Sign Off By}.
  • Questions on the form use the Field Code shown under each question in the Custom Form Builder, for example {SiteLeftSafe}.

Add a Custom Field to the form's template

  1. Go to Advanced > Custom Forms and select View beside the form.

    The Custom Forms list under Advanced, with Download Guide, Add New, Export Selected and Import at the top and a View button beside each form, the View button for Site Inspection highlighted.
    Advanced > Custom Forms. Sample data.
  2. Under Document Template, select the download button beside Upload Template.

    Ascora downloads the form's current Word template.

    The top of the Custom Form Builder with Form Name, Default Attachment Category and the Document Template area highlighted, showing an Upload Template button, a download button and the name of the uploaded Word file.
    Upload Template and the download button. Sample data.
  3. Open the template and type the field code where the value should print, for example {Project Sign Off By}.

    Add a label beside it, put it in a table, or format it however you like.

  4. Save the file on your computer.

  5. Select Upload Template and choose the file.

    You can also drag the file onto Drop template here. The new template is used for every form generated from now on.

Where the value comes from

The value prints from the job's Custom Details, filled in on the web or in the mobile app. For a form on a quote, it comes from the quote's Custom Fields. For a form filled in on a piece of equipment on the job, that equipment's Custom Fields print too. If you want technicians to answer the question in the form itself instead, add a question in the Custom Form Builder and use its field code.

Test the form

  1. Synchronise the mobile app.

    This makes sure the app has your new template.

  2. Open a job and fill in the Custom Field on its Custom Details tab.

    The Android app Schedule screen listing jobs, with the first job card highlighted to show which job to open.
  3. Start a new form.

    On Android, open the Custom Forms tab and tap +. On iOS, tap Forms and add a new form. Search for your form by name, or pick it from the list. Don't use a draft started before your change, as it won't pick up the new template.

    The Custom Forms tab of a job in the Android app showing No Completed Forms for this Job, with the tab and the + button highlighted.
  4. Tap Generate.

    Check that the PDF shows the value you entered.

    A Job Safety Analysis custom form being filled in on the Android app, with the Generate button highlighted at the top right.
A job open in the Android app on its Custom Details tab, with an arrow pointing to the Project Sign Off By Custom Field filled in.
The job's Custom Details tab with the Custom Field filled in.
The generated custom form PDF on the phone, with a callout pointing to the Project Sign Off By value printed below the sign-off table.
The generated PDF shows the Custom Field's value.

Related articles

Was this article helpful?

Related articles

Didn’t find what you needed?

Send the Ascora support team a message and we will help you sort it out.

Contact support