Custom Fields

Custom fields and fieldsets are available in Snipe-IT versions 2.1.0-pre and later.

Custom fields allow you to track additional information about your assets that the default asset attributes don't cover.

Check out the short video tutorial below for a full walkthrough:

Think of custom fieldsets as collections of custom fields. You can have a custom fieldset with just one custom field in it, or multiple custom fields. The idea of fieldsets is to keep commonly used fields grouped together so you don't have to add fields one-by-one to asset models.

Custom fieldsets are assigned at the asset model level. So, for example, if you track mobile phones as Assets, you could create custom fields for "IMEI", "SIM", "Phone Number", etc.

You would then add all of those mobile phone related fields to a new "Mobile Phones" custom fieldset, and assign it to one of your mobile phone asset models.

❗️

WARNING

Encrypting a field makes it unsearchable and unable to be sorted on in the database.

When you're adding a field to a fieldset, you can select whether that field should be required, what order it should appear in, and then select the fieldset to add from the select box.

Then, for any mobile phone assets you create that belong to that asset model, the custom fields attributes will automatically appear.

To break it down step by step:

• Create the new custom fields you want in your custom fieldset.
• Create the new custom fieldset, and add the custom fields you just created.
• Go to Admin > Asset Models and edit an asset model, selecting the custom fieldset you just created.

You can create the fields first, or the fieldset first, but be sure to add the new fields to your fieldset, and then associate that fieldset to an asset model to see those new fields on your asset forms.

Once your asset models have custom fieldsets associated with them, your new values will appear on the asset view and edit pages, and in the main asset listing table. You will be able to search/sort on these fields (as well as show/hide them in the table view) the same as you can the other built-in fields.

Reordering Fields

To change the order that fields appear within a fieldset, use the drag icons and move them up or down in the fieldset list:

The new order will be changed immediately, no need to click the save button.

Because the ordering is specific to the fieldset, you can have different orders for different fieldsets depending on the use-cases you need.

Custom Field Validation

We have provided support for basic input validation on the custom fields you create. When creating the fields, you'll have the option of selecting the Format the text input for your new fields should be in when your admins add or edit assets. You have several pre-defined options:

Format	Description
ANY	No input validation. Any text is acceptable.
ALPHA	The field under validation must be entirely alphabetic characters.
ALPHA-DASH	The field under validation may have alpha-numeric characters, as well as dashes and underscores.
NUMERIC	The field under validation must be numeric.
ALPHA-NUMERIC	The field under validation must be entirely alpha-numeric characters.
EMAIL	The field under validation must be formatted as an e-mail address.
DATE	The field under validation must be a valid date according to the strtotime PHP function.
URL	The field under validation must be a valid URL.
IP	The field under validation must be an IP address.
IPV4	The field under validation must be an IPv4 address.
IPV6	The field under validation must be an IPv6 address.
MAC	The field under validation must be a valid MAC address.
BOOLEAN	The field under validation must be able to be cast as a boolean. Accepted input are true, false, 1, 0, "1", and "0".
CUSTOM	This field allows you to use a regex expression for validation. It should start with regex: - for example, to validate that a custom field value contains a valid IMEI (15 numeric digits), you would use regex:/^[0-9]{15}$/.

🚧

Note:

To import custom fields, please see the Importing notes.

Common Custom Fields Regexes

Multiple Mac addresses: regex:/^([0-9a-fA-F]{2}[:-]){5}[0-9a-fA-F]{2}|([0-9a-fA-F]{2}[:-]){5}[0-9a-fA-F]{2}(,([0-9a-fA-F]{2}[:-]){5}[0-9a-fA-F]{2})*/