Custom Properties

📓 Properties (fields/attributes) are pieces of information that help describe each user in your Contacts section; such as what plan they're on, their job title, or their address.

GoSquared has a standard list of user properties that we recommend you track. For everything else, you can set up your own custom properties.

We know every company is different, that’s why we made GoSquared Contacts as flexible as possible – you can add up-to 1000 custom properties in each GoSquared project.

Adding custom properties

There are currently two methods to add custom properties in GoSquared:

  1. You can ask a developer on your team to help you track custom properties using this documentation.

  2. You can also import custom properties through our CSV importer tool.
    When preparing a list of users to import, just add each custom property as a new column in the CSV.

We encourage you to pass back as many custom properties as you like. Custom properties will be displayed in the right hand sidebar of each user's profile – both in your Contacts section and Inbox.

Editing and removing properties

You can change the value of a property in 2 ways:

  1. People and Inbox interface – hover over the property in the profile sidebar and click 'Edit' to reveal the edit mode.
  2. Through the API – track the property again with a new value to overwrite it, or explicitly track a value of null to remove it from the profile.

We have a 'last update wins' system. This means that the property will always be set to the most recently updated value, irrespective of whether the update was from the user interface or the API.

Change the property data type

The 'type' of data that each property is affects the filtering options that are available in Contacts.

The first time you track a custom property we will automatically classify the data as one of four types:

  • Text
  • Number
  • Date/Time
  • Boolean (true or false – represented as 'yes' or 'no')

If a custom property has been given the wrong type, you can manually change them from Settings > Current Project > Contacts. These settings are applied on a per-project basis.

The filtering options for each data type are shown below:

Text filtering


Number filtering

Number property filter options

Date/Time filtering

The units can swapped between years, months, weeks, days, hours, minutes.

date property filter

Boolean filtering

Simply displayed as Yes or No (representing True or False). Alternatively you can just filter to see if either value has been set or not set at all.

boolean filter options

💬 For more examples on tracking custom properties in GoSquared Contacts, check out our full guide here