> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-carrefour-france-channel.md).

# How to set up a Carrefour France channel

Set up a Carrefour France channel, map product data, connect Mirakl, and activate your listings.

Carrefour France is a French marketplace that uses the Mirakl platform. It specializes in groceries, food, and everyday household items.

In this article, you’ll learn how to set up a Carrefour France channel. You can then create, update, and manage listings in Channable.

***

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

**You’ll need**

* A Mirakl account for Carrefour France
* A Channable project with imported products

**Good to know**

* Channable supports Carrefour France and Carrefour Spain only.
* This guide covers Carrefour France. Select **France** when creating the channel.
* Carrefour can't delete listings. Set stock to `0` and re-run your channel to deactivate a listing.
* Carrefour requires any seller who wants to register new products to send a copy of their feed, in Excel format, to validate all new items.&#x20;

{% hint style="info" %}
For more information about setting up listings for Carrefour Spain, see [How to set up a Carrefour Spain channel](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-carrefour-spain-channel-1.md).
{% endhint %}

{% stepper %}
{% step %}

### Create a Carrefour France channel

1. In Channable, go to **Projects > \[Your project] > Channels**.
2. In the search bar, enter Carrefour and select **Carrefour France**.
3. Set your channel settings:
   1. For **Name**, give your channel a descriptive name (like Carrefour France - FR).
   2. For **Unique ID per item**, select a field containing your product IDs.
   3. For **Attribute language**, choose the language your product data is in.
   4. For **Master rules** (Optional), set a rule group if you already have one to apply to your channel.
4. Click **Save**.
   {% endstep %}

{% step %}

### Categorize your items

Categorize your items so they match Carrefour France’s taxonomy.

1. Go to the **Categories** step.
2. Choose your categorization method:
   1. **Generate from field:** Select a category field, such as `product_type` or `category`.
   2. **+ Add category rule:** Add text-based conditions to assign categories in bulk.
   3. **Copy from channel:** Reuse categories from another channel.
3. Click **Save**.
   {% endstep %}

{% step %}

### Create rules to fill data gaps

Use rules to prepare product data for Carrefour France. Create project fields when later steps show missing data.

* **Rule templates:** Use common rules that you can adapt.
* **Rules setup:** Filter, modify, or enrich fields for marketplace requirements.

{% hint style="info" %}
Carrefour requires a shipping class based on product weight. If you don't have this data already, [create a field and use rules to set the relevant shipping class](/list-advertise/list-on-channels/fill-missing-attribute-data.md). Project fields accept only `XXS`, `XS`, `S`, `M`, `L`, `XL`, and `XXL`.
{% endhint %}
{% endstep %}

{% step %}

### Map shared attributes

Link project fields to attributes that apply across your Carrefour France catalog.

1. Go to the **Build** step.
2. Map each attribute marked **Required by marketplace**.
   * To map an attribute, click its dropdown and select the project field containing that data.

{% hint style="info" %}
For some attributes, you can enter a custom value or select a supported value. This applies the same value to every item.
{% endhint %}
{% endstep %}

{% step %}

### Map category attributes

Category-specific attributes apply only to your product’s categories.

1. In the **Build** step, click **Attributes per category**.
2. Select a category from the list.
3. Map each attribute marked **Required by marketplace**.
   1. To map an attribute, click its dropdown and select the project field containing that data.
4. Click **Save**.

<details>

<summary><strong>Adding multiple attribute values in Mirakl</strong></summary>

Separate multiple attribute values with a pipe symbol (`|`). This helps Mirakl process each value.

</details>

{% hint style="info" %}
For Mirakl marketplace errors and best practices, see [Mirakl guide: settings and solutions](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions.md).
{% endhint %}

**Eco-contributions**

If your company operates in France, add eco-contributions to your offers. See [Setting up Mirakl Eco-contributions](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions.md).
{% endstep %}

{% step %}

### Check the quality of your setup

The **Quality** step checks your channel before activation. Resolve mandatory errors first.

* **View items:** Show products with a specific issue.
* **View in build:** Open missing information in **Build**.
* **Set categories:** Open the **Categories** step.
* **Show source:** Open **Settings** for ID fields.
  {% endstep %}

{% step %}

### Preview before activating

The **Preview** step shows mapped attributes and potential errors.

* Use **All** to filter products with errors.
* Use **All categories** to filter a category.
  {% endstep %}

{% step %}

### Connect to Carrefour France via Mirakl

To send listings to Carrefour France, connect your channel to your Mirakl Connect account.

{% hint style="info" %}
Linking your account does not change existing listings. Changes begin after activation.
{% endhint %}

1. Log in to your Mirakl Connect account.
2. In **\[your Carrefour France channel]**, go to **Settings**.
3. At **Linked seller account**, click **Select seller account**.
4. Select an existing seller account, or click **+ Add new connection**.
   1. If you add a seller account:
      1. For **Name**, enter a name for the connection. This only identifies the connection in Channable.
      2. Click **Connect with Carrefour**.

Channable redirects you to Mirakl to authenticate the connection. After you sign in, you return to your channel.
{% endstep %}

{% step %}

### Activate and run your channel

If needed, [activate your project first](#user-content-fn-1)[^1].&#x20;

1. Return to the **Settings** step in your Carrefour France channel and click **Activate API**.
2. Click **Save**.
3. Click **Run now** to send your product listings to Carrefour France.
   {% endstep %}

{% step %}

### Review and fix listing errors

After you run your channel, the marketplace provides feedback about missing listing data. Treat each run as part of an iterative process!

To review feedback and resolve errors, go to the **Result** step and click the **Feedback** tab.

**Resolving errors**

1. In **Description**, click the error name. This opens an overview of products with that error.
2. In **ID**, click the ID number and scroll to the error callout. Hover over the callout for more information.
3. If the error is a mapping error, click **View in build**. This opens the attribute that you need to map or remap.
4. For more information about the attribute and its accepted values, hover over .
5. Resolve the error.

{% hint style="warning" %}
Carrefour can't remove products from your account. Send the product again with stock set to `0` to deactivate it.
{% endhint %}
{% endstep %}
{% endstepper %}

[^1]: If in a channel, click **Back to channels** to return to your channel overview. Then click **Project settings** > **Activate project** > **Save**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-carrefour-france-channel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.