Using the "Mapped Terms" field

Last updated on

19 December 2018

Visit the fields list for your index at Admin > Configuration > Search API > [your index] > Fields (path /admin/config/search/search-api/index/YOUR_INDEX/fields)
Click "Add fields"
Click the "Add" button for the "Mapped terms":
Once you have added the "Mapped terms" field to your search index configuration, you can read through the provided instructions and save the field:
Remember to save the index field configuration:
Configuration for mapped terms happens within the taxonomy term entity edit UI itself. Browse to a taxonomy vocabulary on your site and add an instance of the "Mapped terms" field type (If you plan on sharing this field among your vocabularies, use something like "Mapped terms" for the field label).
Save the field settings
Edit any terms in the vocabularies to which you've just added a "Mapped terms" field instance. On the term edit form, you should now see a "Mapped terms" field instance where you can add one or many "mapped" terms.
Repeat for each term in each vocabulary which should have a mapped term value.
Once content which references these terms is indexed, all of their corresponding "mapped terms" will appear in the mapped_terms index property field.