Manage Custom Fields

You can manage Custom Fields through the Admin menu - click the cogwheel upper right-hand side of Mautic.

Screenshot of Admin menu

Custom Fields

The Custom Fields page lets you view all existing Contact fields as well as any custom Contact fields you have created.

Screenshot of Custom Field

You’ll notice the group column shows the specific field on the Contact profile. In the last column, you may see several icons which signify various properties of the field:

Screenshot of Custom field icons

  1. Lock icon - The core installation uses these fields, you can’t remove them.

  2. List icon - You can use these fields as filters for Segments.

  3. Asterisks icon - These fields are required when filling in the Contact Form

  4. Globe icon - You can update these fields publicly through the tracking pixel URL query see Contact Monitoring for more details.

It’s important to note that from Mautic 5, you won’t be able to edit the default value for any Fields used to identify a Contact or Company, including:

  • Email

  • Company

  • First name

  • Last name

  • Social profiles

  • Unique identifier fields

  • Company name

  • Company Email

  • Company website

  • State

  • Country

  • City

Published fields

There is a toggle switch which shows before each label title. You can find this type of switch throughout the Mautic UI for publishing and unpublishing items.


Adding a new Custom Field

You can create additional custom fields and define the data type you want that field to hold. In addition to the data type you select the group for that particular field. This defines where the field displays on the Contact edit and detail view.

Screenshot of New Custom Field

Creating Custom Fields via a command

When you create a new Custom Field for Contacts or Companies in Mautic, the system adds a new column to the database. For larger instances of Mautic, this operation can slow down, and the table remains locked while running. As a result, you can’t make any changes until the system creates the field. The HTTP request may time out, causing the User Interface to report that the column exists even though Contact/Company updates may fail because the column is still missing.

There is a way around this when you configure the processing of field creation in the background.

Since Mautic 3.3 there is an option you can set in your app/config/local.php file: 'create_custom_field_in_background' => true,.

If you configure this option, the new Custom Field becomes visible in the list of Custom Fields. The custom field remains unpublished until you run the command bin/console mautic:custom-field:create-column. This command creates the actual column in the table and publishes the field metadata.

This configuration helps prevent http request timeouts because it handles the long-running SQL query to create the new table column as a background task.

To mitigate the table lock issue, run the command only once daily when you know that most of your audience is offline. With less traffic going into Mautic, the chances of encountering a problem are lower.