Field Aliases

For Doofinder to work on your website, you need to index the product data you want to make available when searching. This can be done indexing through the data feed, if you are indexing via API, please refer to the API documentation.

There are cases where the data feed has different field names than Doofinder’s default. In these cases, it is not necessary to create a new feed if it already contains all the required fields. If, however, the data feed does not contain all the required fields, you can add them through the Field Aliases section.

📌 Note: If you prefer, you can use the Google Shopping (GS) feed, following their specifications. The field names also do not have to match the GS specifications.

Accessing the Field Aliases Section

You can only access the field aliases section through the admin panel. Here’s how:

1.In your Admin Panel go to Search Engines > Settings > Indices.

access field aliases

2.Next to the Product button on the product tab, select the three dots arranged in vertical order. This will display a dropdown list with two options.

  • Field name mapping
  • Delete
field aliases options

3.Select Field name mapping as shown in the preceding image. The Field mapping section will pop up, from which you can edit the Normalized Field Name and the Field Aliases.

enter field normalized name and aliases

If the field names in your data feed match those in the field aliases’ section, you should not do anything else. However, if they don’t match, you’ll only need to add the field name from your data feed in the field aliases’ box corresponding to the normalized field name.

4.Save the changes. In the next indexing, Doofinder will apply the new aliases to get and/or display the relevant data from the data feed.

To add a new field, click on the '+Add new field' button.

How it works

First Index

To get your data feed properly indexed, Doofinder requires the id & title. If one or both of them have a field name in your feed that is not in the expected field aliases, Doofinder will not recognise it, and the index will deliver an error message such as this:

field mapping errors

You can use the normalized field names section to fix this by setting the correspondence between the field name in the data feed and the normalized one. Once completed, save the changes.

The layer doesn’t show some info in the results

Doofinder should show the following fields in the results layer:

  • image_link
  • title
  • price
  • sale_price (if it exists)
  • link

If some of this data is missing, the problem could be a non-recognized field name in your feed. To fix it, detect the non-recognized field name and configure the alias.

Say, for instance, we need a title field sent to Doofinder. If the data you sent in the field is called product_name, you should customize the field title with the field product_name.

Depending on how the feed export is configured, you should know the name of this field from your feed.

Otherwise, you can open the feed and check it.

📌 Note: Deleting a normalized field name line will not remove the customized normalization or data. Doofinder will always apply the customized normalization in the background. Therefore, you cannot use this tool to hide data shown in the layer; for instance, you cannot remove the prices from the layer by deleting the aliases.