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.
Create a But connection
In Channable, go to Projects > [Your project] > Channels.
Click + Create channel.
In the search bar, enter “But” and select But.
Click + Add a new connection.
At Connect with, click But to select it.
For Label, give your connection a descriptive name (e.g. “But FR”).
For Shop ID, paste the Shop ID for the platform you want to list on.
Click Connect with But. You will be redirected to Mirakl to log in to your account and verify your connection.
Confirm any permissions. You will be redirected back to Channable.
Click Create to finalize your connection.
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.
Create your product listings in Channable
Follow the steps below to set up your channel.
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
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.
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.
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.
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.
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:
SellerArticleIdandSellerProductId.SellerProductIdis the Parent ID, whileSellerArticleIdrefers to variant items.For single products, both
SellerArticleIdandSellerProductIdmust be filled with the same value.
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.
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
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.
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).
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.
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.
Last updated
Was this helpful?