How to: add custom attributes

A custom attribute is a data you track about your users, for example, what timezone your user is in. It's a powerful feature because you can filter and target users based on the custom attributes you add, and the data you send to us. It allows you to pass information to Inline Manual that is important to you. This means that you have much more flexibility and you can target your users more accurately. 

By default, Inline Manual supports following keys for people tracking: uid, email, username, email, name, created, updated, roles, group, and plan. In this article, we'll show you how to set up custom attributes to have more control over who sees topics.

How to add custom attributes

  1. Choose the correct site and go to the People tab.

  1. Click People attributes on the left side of the screen.

  1. You'll be redirected to the People attribute settings. You can edit here existing attributes (you can change the title), add new custom attributes, and see how many free slots you have left for custom attributes.

  1. To add a new custom attribute, click Create custom attribute button.

  1. Provide required information:

· Title
· Description
· Format: Text, Number, Array, Date
· Key will be generated automatically based on the title.

Custom attributes limits:
Text - text value must be a string. The maximum length is 128 characters. Use double quote around text strings. Example: name: "John Doe"
Array - the maximum amount is 10 values, max. 64 characters each. Use double quote around each value. All values have to be separated by commas and placed in square brackets. Example: roles: ["admin", "editor"]
Date field - date values must be in UNIX Timestamp format in seconds. The limit is +/- 10000. Send date values without double quotes or brackets. Example: created: 1360610467
Number - the limit is +/- 9007199254740991. Send date values without double quotes or brackets. Example: some_key: 1234

  1. Confirm adding the custom attributes with Save changes button.

Be careful with adding custom attributes as you cannot delete them! You have 3 slots available per format.
  1. When you hover over the attribute, you'll see the option to copy the key to your clipboard. After clicking the button, you'll see a confirmation message.

  1. Add your custom attribute (key) to the People tracking code you've implemented to pass information to Inline Manual.

Done!

Was this article helpful?