Skip to main content
Use Property management to register custom user properties and choose which ones to encrypt. For sensitive information such as a name or address, register the property and turn on encryption before sending data. Notifly encrypts the property value in addition to encrypting the database. When you use the property as a personalization variable, Notifly decrypts the value for the message. These settings apply to custom user properties. Notifly encrypts the built-in email and phone number fields before storing them. You cannot turn off encryption for those fields on this screen.

Naming rules for user property and event parameter keys

Custom user property keys and event parameter keys must match the regular expression ^[A-Za-z][A-Za-z0-9_]*$.
  • Start with an uppercase or lowercase ASCII letter (A–Z or a–z).
  • After the first character, use only ASCII letters, digits (0–9), or underscores (_).
  • Use only the ASCII characters listed above. Spaces, accented letters, periods (.), dollar signs ($), and carets (^) are invalid.
For example, delivery_address and productId2 are valid. Notifly stores data even if its keys do not follow these rules, but some features may not support those keys. For example, a user property with a period in its key, such as delivery.address, has the following limitations.
  • It does not appear in campaign condition searches.
  • It does not appear in the user list or on user detail pages.
  • It is excluded when you export the full user list to CSV.
  • It does not appear in Property management, so you cannot configure encryption for it.

Register a property

  1. In the Notifly console, select the product and environment you want to configure.
  2. Open User Management > User List and click Property management.
  3. Click Add property.
User property list and the Add property button
  1. Enter a Property name that matches the key you send. For example, if you send the shipping address as delivery_address, register that exact name.
  2. Turn on Encryption if the property contains sensitive information, then click Add.
Property name field and encryption setting
Registering a property does not create a user or set any values. You can prepare the property and its encryption settings before collecting user data.

Configure encryption

Turn on encryption

  1. In Property management, click the switch next to the property.
  2. Review the notes. Check whether the dialog lists campaigns or user journeys you need to update.
  3. Click Turn on encryption.
It can take up to 15 minutes for changes to encryption settings to take effect.

Check the impact on campaigns and user journeys

When you try to turn on encryption, Notifly checks the conditions of active campaigns and user journeys that use the property. Encryption stays off if any of those conditions are unsupported for encrypted properties. The confirmation dialog lists the campaigns, user journeys, and conditions you need to update. For example, if a campaign uses Contains with address, change that condition.
Campaign and user journey conditions that prevent encryption
Open the listed campaigns and user journeys and update their conditions. Return to Property management and turn on encryption again.

Turn off encryption

Before turning off encryption, confirm that it is acceptable for existing values to appear in plain text. After the change takes effect, the console can show those values and the SDK may receive them. Notifly does not decrypt stored ciphertext in bulk.
  1. Click the switch next to the encrypted property.
  2. Review Before disabling encryption.
  3. Click Turn off encryption.
Notes and confirmation button for turning off encryption
Notifly skips the campaign and user journey condition check when you turn off encryption.

Use encrypted properties

View user information

On the user detail page, a lock icon appears next to each hidden encrypted value. Properties without encryption remain visible.
Masked name property on the user detail page

Audience conditions

You can use only the following operators to define an audience with an encrypted property.
  • Equal matches users whose value equals the value you enter.
  • Not Equal matches users whose value differs from the value you enter.
  • Exists matches users with a value for the property.
  • Not Exists matches users without a value for the property.
Substring, prefix, suffix, and numeric comparisons require an unencrypted property.
Operators supported for encrypted properties in campaign audience settings

Message personalization

You can use encrypted properties in personalized messages. For example, you can insert a recipient’s name stored as an encrypted property into a message. Even if the console masks a value, the recipient sees it in the personalized message. Check that the information is appropriate to show to the recipient. For setup instructions, see Message personalization.

Limits

  • In segment conditions, use one of the supported operators. You can also use encrypted properties in message personalization.
  • Turning encryption on or off can take up to 15 minutes. The previous setting can remain in effect until the change applies.
  • If an encrypted user property changes during a session, Notifly checks whether the user qualifies to see a popup the next time it looks up the user’s state.