# Bulk map attributes for Amazon

In this article, we explain how to use the **Bulk map attributes** feature to update a category attribute across multiple categories at once for your Amazon channel.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**Good to know**

* Bulk mapping is currently only available for Amazon channels.
* Bulk mapping only works for attributes that exist in multiple categories.
* You can apply one [value type](#user-content-fn-1)[^1] at a time to one attribute.
* List attributes and nested attributes (such as tables) are not supported.
* <i class="fa-sparkles">:sparkles:</i> **Auto-map fields** and <i class="fa-list-check">:list-check:</i> **Bulk map attributes** are separate features
  * Auto-mapping uses AI and references similar setups to suggest mappings for **Shared attributes** and all attributes in a specific category.&#x20;
  * Bulk mapping is designed to update a specific attribute across different categories at once.

{% hint style="success" %}
**Tip:** If you want help with suggested mappings first, see [Auto-map fields for marketplaces/APIs](/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis.md).
{% endhint %}

{% stepper %}
{% step %}

### Open Bulk map attributes

1. In **\[your Amazon channel]**, go to the **Build** step.
2. Open the **Attributes per category** tab.
3. Click **Bulk map attributes**.
   {% endstep %}

{% step %}

### Select an attribute to update

1. Click the **Amazon attribute** dropdown to see a compiled list of all category-specific attributes in your Amazon channel.

The list helps you judge impact before you apply changes:

* **Found in \[x] categories:** Shows how many categories include the attribute.
* &#x20;**\[x] / \[x] mapped:** Shows how many categories already have a value mapped to the attribute.
* **Mandatory in \[x] categories:** Indicates whether the attribute is mandatory for a category.

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

2. Click the attribute you want to update across categories.
   {% endstep %}

{% step %}

### Select an action and value to apply

Select what action you want to perform for the attribute:

<details>

<summary>I want to bulk map the attribute to a value (<strong>Map to value</strong>)</summary>

1. Select **Map to value**.
2. Click the `-` dropdown to select how you want to fill the attribute:
   1. To apply a dynamic value based on the item, select the relevant project field from your data ( <i class="fa-file">:file:</i> **Project fields** > **\[relevant project field]**)
   2. To apply a fixed value across all items, select a [supported value](#user-content-fn-2)[^2] or fill in a [custom value](#user-content-fn-3)[^3].

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

{% hint style="success" %}
**Tip:** To save time, use <i class="fa-file">:file:</i> **Project fields** when values differ per item, and a fixed value (<i class="fa-list">:list:</i> **Supported values** or <i class="fa-pen-to-square">:pen-to-square:</i> Custom) when the same value applies everywhere.\
\
You can create and fill new project fields through [rules](/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules.md).
{% endhint %}

</details>

<details>

<summary>I want to bulk remove values from the attribute (<strong>Remove current mapping</strong>)</summary>

1. Select **Remove current mapping** and continue to the next step.

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

</details>
{% endstep %}

{% step %}

### Review affected categories

You can select or clear categories if you only want to apply changes to specific categories.

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

* <i class="fa-square">:square:</i> (**checkbox)**: includes or excludes the category from your proposed changes. By default, all categories are selected.
* **Categories**: the categories containing the selected attribute
* **Channel attribute**: the attribute to be updated.
* **Current mapping**: what information/data the attribute is currently referencing (if any)
* **New mapping**: shows the value (manual, project field, or supported value) you're about to apply.

{% hint style="warning" %}
**Important:** The attribute name can differ slightly between categories.
{% endhint %}
{% endstep %}

{% step %}

### Apply changes

1. When you're happy, click **Apply changes**.
2. A modal will appear detailing the attribute and the categories it was mapped/unmapped to.

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

Click **View in Quality** to see the impact of your changes.
{% endstep %}
{% endstepper %}

For more details on attribute mapping in marketplace channels, see [Marketplaces: Build step](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step.md).

[^1]: Mapped values can be static (the same across all items) or dynamic (changes based on item). \
    \
    If you select a supported value or enter a custom value, it is static.

[^2]: A known accepted value for this attribute from the marketplace. It is fixed per item.

[^3]: Enter a value in the textbox to directly apply a fixed value.&#x20;


---

# 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/amazon/list-items-on-amazon/bulk-map-attributes-for-amazon.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.