# How to set up a But channel

But is a French online store specializing in furniture, home decor, and interior equipment. They offer a wide range of affordable products, including high-tech items and household appliances.

In this article, you'll learn how to set up a But channel to create and manage listings on But.

***

### Before you start

**You'll need**

* A Mirakl SSO account

**Good to know**

* But requires all listing descriptions to include important information related to the delivery of the product (e.g. shipping time, delivery method). Without this information, But will reject your listing.

{% stepper %}
{% step %}

### Create a But connection

1. In Channable, go to **Projects** > **\[Your project] >** **Channels**.
2. Click **+ Create channel**.
3. In the search bar, enter “But” and select **But**.
4. Click **+ Add a new connection**.
5. At **Connect with**, click **But** to select it.
6. For **Label**, give your connection a descriptive name (e.g. “But FR”).
7. For **Shop ID**, paste the Shop ID for the platform you want to list on.
8. Click **Connect with But**. You will be redirected to Mirakl to log in to your account and verify your connection.
9. Confirm any permissions. You will be redirected back to Channable.
10. Click **Create** to finalize your connection.
    {% endstep %}

{% step %}

### Configure your channel settings

After creating your connection, set your But channel settings:

* For **Name**, give your channel a descriptive name.
* For **Unique ID per item**, select the field containing your product ids (this is often 'id').
* For **Language**, select the language your product data is in.
* For **Use master rule group**, select a master rule group to apply to your channel (if you have one).
* Click **Save**.
  {% endstep %}

{% step %}

### Create your product listings in Channable

Follow the steps below to set up your channel.

{% stepper %}
{% step %}

#### Categorize your products

To set up your product data, assign categories to your products.

* **AI product categorization:** Automatically assigns product categories through our algorithm.
* **Manual Categorization:** Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
* **Uncategorized Items:** Products that still need to be reviewed and categorized

[Learn more about categorizing for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step)
{% endstep %}

{% step %}

#### Set up rules

Rules help you quickly optimize your product data for the marketplace you want to sell on.

* **Rule templates:** Commonly used rules you can adjust for your use case.
* **Rules setup:** Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

[Read more about using rules for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step)
{% endstep %}

{% step %}

#### Build your listings

The **Build** step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

**Mandatory and optional fields**

* **Mandatory fields**: Required to list your products on this marketplace
* **Recommended**: Recommended to avoid errors and improve performance

**Shared attributes**

* Shared attributes are common fields that apply across your products, such as EAN, prices, and titles.
* **Use static or dynamic Values**
  * **Static values:** Fixed values that don’t change (e.g. brand name, manufacturer)
  * **Dynamic values:** Fields that automatically change based on the linked data (e.g. stock, prices)

**Category-specific attributes**

* Fields that specifically apply to the category for your products (e.g. size for clothing or dimensions for furniture).
* Fill in attributes that are specific to the selected category.

[Learn more about the Build step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step)
{% endstep %}

{% step %}

#### Check the quality of your set up

The **Quality** step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.

* Solve errors, prioritizing mandatory errors first.

**Actions**

* **View items**: See products with specific issues.
* **View in build**: Redirects to the **Build** step to map missing information.
* **Set categories**: Directs to the **Categories** step to categorize items.
* **Show source**: Available for ID fields. Directs to the **Settings** step.

[Learn more about the Quality step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step)
{% endstep %}

{% step %}

#### Preview before activating

The **Preview** step displays the attributes you mapped in the **Build** step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.

Filtering:

* **Filter by error:** Click the **All** dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
* **Filter by category:** Click the **All categories** dropdown and select the category you want to filter by.

Before you continue:

* **Review Shared attributes**: Ensure all mandatory shared attributes are filled.
* **Review Category-specific attributes**: Ensure all mandatory category-specific attributes are filled.
* **Check for errors**: Correct any red-marked fields.

[Learn more about the Preview step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step)
{% endstep %}
{% endstepper %}

### Best practices for Mirakl marketplaces

* Adding multiple attribute values: Separate multiple values in an attribute with a pipe symbol "|" for proper detection and processing.
* Seller's Product ID for single/simple products: Two attributes exist: `SellerArticleId` and `SellerProductId`. `SellerProductId` is the Parent ID, while `SellerArticleId` refers to variant items.
  * For single products, both `SellerArticleId` and `SellerProductId` must be filled with the same value.
    {% endstep %}

{% step %}

### Additional requirements for But

The following information is specific to But and includes details about the Item tab and additional requirements.

#### Shared attributes — Item section

* Shipping class (logistic class): Enter the logistic class of your product to determine shipping costs.
* Lead time to ship: Indicate shipping time in days (time until package is handed to shipping).
* Eco-contributions: If operating in France, add eco-contributions to your offers. See list of [available EPR categories](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions).
* Price excl. VAT: Indicate the VAT; set the value to "20".
* Private Copy Tax: For applicable blank media items, specify the 'copie-privée' levy amount in euros.
* Warranty list: Indicate the legal guarantee of 2 years (use "2-years" with a dash).

#### Title Requirements

* Maximum number of characters: 100
* Title structure: Product type, function, style, color, material, dimensions
* Brand name exclusion: Do not include the brand name in the title (the trademark field is automatically placed before the title on the site).
* Dimensions: Specify units (e.g., H.10 cm). Do not use acronyms. Example: Ø
* No commercial terms: Do not display terms like "Exclusive", "New", "Top seller", etc.
* Special characters: Do not include special characters (e.g., Greek letters).
* No leading dash: Do not start the title with a dash.

#### Image Requirements

* First visual: Must be on a white background, detoured (cut out).
* Positioning: From the front or a ¾ angle.
* Number of visuals: Up to 6 visuals showcasing different angles (background photo, diagram, accessories, details, etc.).
* Recommended formats: 2000×2000 pixels, 3000×3000 pixels.

#### Description Requirements 

{% hint style="warning" %}
**Important:** The Description attribute is mandatory. It must include information about shipping time, delivery method, and any other carrier-delivery details. Without this information, But will reject your listing.
{% endhint %}

* Character limit: Max 8,000 characters.
* No external links: Avoid links or references to external sites or shops.
* Use HTML for enhancement: HTML can be used to enrich descriptions (HTML is blocked on Mirakl by default; contact your account manager to enable it).
  {% endstep %}

{% step %}

### Send your product listings to But

1. Select the **Settings** step in **\[your But channel]**.
2. Click **Activate API**.
3. Click **Save**.
4. Click **Run now** to send your product listings to But.
   {% endstep %}

{% step %}

### Check your product listings for errors

Go to the **Result** step and click on the **Feedback** tab. This page displays all processing errors your product data has at a given moment.

{% stepper %}
{% step %}

#### View products with a specific error

1. In **Description**, click on the error name. This shows an overview of products with that error.
2. In **ID**, click the ID number and scroll. You should see a red highlighted callout where the error occurred. Hover over the callout for more information.
   {% endstep %}

{% step %}

#### Resolve mapping errors

* If the error is a mapping error, click **View in build** to be directed to the attribute you need to map/re-map (highlighted in blue).
* For more information about the attribute and its accepted values, hover over the attribute help icon.
* Resolve the error.
* Repeat for remaining errors. When ready, run your channel again by clicking **Run now**.
  {% endstep %}

{% step %}

#### Check successful listings

You can check your successfully listed products in the **Successful** tab.
{% endstep %}
{% endstepper %}
{% endstep %}
{% endstepper %}