Merge tags
This page describes merge tags and how to use them in Contentful.


Merge tags or personalization tags allow you to insert data and dynamic visitor content. For example the visitors city.
Default location merge tags are available on selected accounts. Contact us to enable location merge tags..

How to add a merge tag

To add a merge tag to a rich text field click Embed inline entry and select a Nintetailed Merge Tag.

Location merge tags

  • City of the visitors, e.g. "Berlin"
  • Country of the visitors, e.g. "Germany"
  • Postal code of the visitor, e.g. "10214"
  • Region of the visitor, if known, the ISO 3166-2 name for the first level region, e.g. "Berlin".
You can localize the city and country merge tags adding the locale code in the <PersonalizationProvider locale ="YOUR_ISO_LOCALE"/>

User traits merge tags

You can set unlimited user traits merge tags with the identify analytics call, e.g. first name, role or company.

Add merge tags

To use your user traits merge tags in Contentful add a new entry for every trait, e.g. first name.
  1. 1.
    Create a new merge tag.
  2. 2.
    Add the ID of your user trait. Use the prefix traits_ and your trait name, e.g. traits_firstname.
  3. 3.
    Publish the entry.
Last modified 2mo ago