Push source item metadata

Metadata is a key-value pair that typically provides a single specific piece of information about an item (for example, its author name). You can push as many distinct metadata key-value pairs as you need with each individual item you add or update in a Push source.

To be useful, metadata must populate at least one field in the index of your Coveo organization. By default, when the Coveo indexing pipeline processes a Push source item, it tries to map each incoming metadata key to a field of the same name in the index. This process is called automatic mapping.

Notes

Only a few Coveo source types support automatic mapping for incoming item metadata. With many other source types, you must define mapping rules explicitly to populate index fields with incoming metadata.

Automatic mapping doesn’t prevent you from configuring the Push source with custom mapping rules for specific metadata. Custom mapping rules specified for a given metadata key override automatic mapping.

In summary, if you plan to index the values for a given metadata key, ensure you first create a field with the same name, unless you plan to define a custom mapping rule to handle that metadata.

The following diagram illustrates the metadata mapping process for sources with automatic mapping enabled:

Metadata auto-mapping flow

The articles in this section help you push item metadata effectively: