# Auto-map fields for marketplaces/APIs

The Auto-map fields feature helps you quickly map your product data to marketplace attributes in the **Build** step of your marketplace channel (API). This feature uses smart suggestions to automatically fill in empty attribute fields, saving time and reducing manual effort.

These suggestions are based on:

* The **category** and **attributes** you're currently mapping.
* **Attributes you've previously mapped** within the same project.
* **AI suggestions** based on the fields available in your project.

### How auto-mapping works

Auto-map recognizes patterns and uses existing data to suggest fields to map for your attributes. It prioritizes fields you, or others with similar channel setups, previously mapped based on shared field names and types.

#### How the suggestion hierarchy works:

1. **Your previous mappings:** Auto-map first looks at fields you've mapped in other channels within the same project. For example, if you mapped `item_color` to `color` for one Amazon channel, it will suggest the same selecting the same field for that attribute.
2. **Similar channel setups:** If you haven't mapped a particular field before, auto-map suggests mappings based on how others with similar channel setups have mapped their attributes.

> ### Example: Selling on Amazon (Germany → Netherlands)
>
> If you've mapped the `item_color` field to the `color` attribute in an Amazon channel where the region is set to Germany, and you create a new Amazon channel with the region set to the Netherlands, Auto-map will use your German channel to suggest the same fields for your Dutch channel. This means your `item_color` field will automatically be suggested for your `color` attribute in the new Dutch Amazon channel, saving you from having to find and map it manually.

### How to use mapping suggestions

1. In the **Build** step, click on the **Attributes per category** tab.
2. Click **Auto-map fields**. We’ll automatically fill empty attributes with suggested matching values if we have any.
3. Review the proposed suggestions carefully.
4. Click **Save** to save the suggested attributes.

{% hint style="info" %}
**Note:** Auto-map suggestions won't override any attributes you've already mapped. It only fills in empty fields. Always review the suggestions before saving.
{% endhint %}

<figure><img src="/files/f9c48d74683cabedf18a6d1c1f8fbf63f6bae537" alt=""><figcaption></figcaption></figure>

### Clearing suggested fields

If you want to remove the auto-mapped suggestions, you have a couple of options:

* To clear all suggestions, click Clear all or refresh the page without saving.
* To clear individual attribute suggestions, click . next to the specific attribute field.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.