Custom Fields
Teresa Bui avatar
Written by Teresa Bui
Updated over a week ago

Our Custom Fields module allows you to create more fields on your assets, properties, tasks, clients and more. This allows our customers to customise their Uptick system to help add more information to reports or just add specific fields that Uptick doesn't offer, yet is a strong part of your company's processes.

A good example would be to add a new field to your assets for Fire Rating or Hinge Types.



Once the extension is enabled by us and permissions are applied, go to Control Panel > Custom Fields.

From here, you can create new fields or modify the configuration of existing custom fields you've added.

Adding a custom field

  1. Click Add Custom Field

  2. Fill out the fields:



The name of the field.


Automatically generated from the label (this is the name of the field that Uptick uses to add to reports)

Help text

Provide your own context to the field which will appear as a sub-heading.

Object Type

This is the area of Uptick you would like the field to sit, for example, if I want to add a new field to my properties in Uptick, I want select Property here. Available object types are:

  • User Preferences

  • User (on a users profile)

  • Product

  • Client

  • Property (can be viewed/edited on mobile app)

  • Tasks (can be viewed/edited on mobile app)

  • Task session

  • Asset types

  • Asset Type Variant

  • Assets (can be viewed/edited on mobile app)

  • Contractor

  • Remark

  • Remark Type

  • Routine Service Level

  • Routine Service Level Type

  • Routine Service

  • Billing Contract
    Note: Billing contract custom fields can only be populated by importing the data

  • Quote (Defect Quote)

  • Service Quote

  • Service Task

  • Purchase Order

  • Invoices

  • Report Type

  • Report

  • Branch

  • Accreditation

  • Accreditation Type

  • Purchase Order

  • Supplier


Widgets define the type of field the custom field will be and will determine the type of data the field takes. Available widget types are:

  • Text

  • Multiline Text

  • Integer

  • Choice (drop down options that can be selected)

  • Date

  • Decimal (allowing for decimal values up to 2 decimal spaces such as currency)


The order in which you display your custom fields if there are many, 1 being the top of the list.


Ticking this will make the custom field a required field.

3. Once all the details have been filled out, click Save

4. If you've picked a Choice field, you need to now add the drop down options for your Choice field. This is a requirement for this field otherwise you won't have anything to select from when your office or field staff use this field! Once your field is saved, click Edit on the field again and you'll see an Options section. All you need to do here is type in the Label field your first dropdown option and click Add Option once done, repeat for multiple options. It's important to note that you should not touch the Value field of these choices.

Make the field apply to specific user categories

Edit any created Custom Field and under the Visible to heading, select/deselect which user types will be able to see this custom field.


Make the field only show up for certain asset types, variants, clients etc..

You may require a large number of fields that are only applicable for certain asset types, variants, properties or client. For example, the FRL field should only show if the Asset is of type "Door" or a unique id needs to be filled out on a property for a certain client.

Edit the field you are wanting to add this to, and click Add Condition. You are given two areas you need to fill out, a key and a value.

Note for a custom field condition, you can only use keys from related objects, for example:

asset -> assettype

asset -> property

asset -> property__client

property-> client

Note that there is a difference between property__client and client. When creating a custom field for an object that belongs a property such as assets, property__client needs to be used to only make it visible to the client. However if the property is the object type, then client needs to be used as it is referring to the property itself and not the object belonging to the property.

The following common conditions have been outlined below, contact support to enquire about other possible conditions:

Only applicable to certain asset type:

key = type

value = id/s of asset types in your system you want this field to be applicable to

Only applicable to a certain variant:

key = variant

value = id/s of variants in your system you want this field to be applicable to

Only applicable to a certain client:

key = property__client

value = id/s of clients in your system you want this field to be applicable to

IMPORTANT NOTE - ensure the condition ID's are entered without any spaces and kept on the same line. If the same key is used with a different ID on each new line, the mobile app interprets this to only display if ALL of the conditions are true.


The variant id can be found in the URL when you view any variant on the asset type.

Filtering by Custom Field

Filtering by custom field is as simple as selecting the field from the Add filter drop down list, and is available on the following pages:

  • Tasks

  • Assets

Make sure that you select either Task or Asset as the Object Type when creating the custom field in order to make that filter available on the Tasks/Assets pages respectively.

Filtering logic of custom fields

The filtering logic is determined by the custom field widget type so take this into account if you plan on using the custom field as a filter. See the table below to understand the filtering logic for each widget type:

Widget Type

Filtering logic

Text, Multiline Text

Contains/Does not contain


Is/Is not


Fixed date/Relative to now


Number field and slider


Managing custom fields against assets/asset types

You can get an overview of custom fields set against assets and asset types by going to:
Control Panel > Asset types > View the asset type > Custom attributes.

This overview provides a summary of configuration elements such as:

  • Field name

  • Widget

  • Permissions

  • Restricted to variants

  • Restricted to clients

The Customise button in the upper right corner of the summary is a direct shortcut the Custom fields section of the control panel, where you can edit or create new custom fields.


An Example to get you started

You're on the Custom fields configuration page and you're adding a few new fields - one new field on your properties to help determine whether this property has a Fire Engineering Report and another new field on your assets for Fire Resistance Level of that asset.

Field 1:

Label: Fire Engineering Report

Key: fireengineeringreport

Object type: property

Widget: Choice (which I later add 'yes' and 'no' to the drop down options)

Required: Yes

Field 2:

Label: FRL

Key: frl

Object type: asset

Widget: text

Required: No

Did this answer your question?