Mappings are designed to help us organize and structure content while improving the SEO on our website.

The markup in adds meaning to your content for search engines but the real benefits come when you use structured data as the basis for your content model.

We call it the entity-based content model and you can learn more about by watching the following webinars:

Or by booking a call with our SEO experts..

WordLift mappings have been developed as an integration for the Advanced Custom Fields plugin and allows you to either:

  • re-use fields that you might have already configured with ACF on your CMS or,
  • create new fields based on the taxonomy

WordLift loads automatically the latest version of and allows you to personalize your content model easily while taking care of the injection of the json-ld on your pages.

Getting Started



Add Custom Fields

First create a new custom field by clicking on Field Group and choosing a title.

_images/mapping-custom-fields.png _images/mappings-field-group.png

Then add your first field

  • Field Label is what the user will see editing a post
  • Field Name from (e.g. endDate)
  • Field Type “Date time picker” in the case of endDate
  • Instructions for authors. Shown when submitting data
  • Required? whether this field is needed or not in order to publish a post
  • Default Value, you can fill this box if you want a default data when creating a post
  • Placeholder Text, appears within the input
  • Prepend, appears before the input
  • Append, appears after the input
  • Character Limit
  • Conditional Logic
  • Wrapper Attributes
  • Location
    Rules, here you can choose to use this ACF if for example your Post Type is equal or not equal to one of your Post Types

This is how it looks for authors while creating or editing a post:


Add New mapping

First go on Types and Sync classes

_images/mappings-schema.png _images/mappings-sync-schema.png

Then go on Mappings and add a new one.


Choose a title and at least one Rule


Add at least one Property:

  • Property name, give a name to your property
  • Field Type, select ACF to use Custom Fields
  • Field Text, choose which custom field to use for that property
  • Transform Function