Mirakl Seller Documentation

Accessing Mirakl back office

You should have received your Welcome Email from the Lowe’s Business Development team once your seller account is approved. This email will contain:

• Your Mirakl Seller back office access link
• Initial onboarding steps and documentation

About this Guide

This documentation covers:

• How to onboard with Mirakl
• Product and offer data requirements
• Feed templates for Excel uploads
• API usage (for technical teams)
• Reference guides for titles, barcodes, attributes, and more

As you move through onboarding, Lowe's Marketplace Team recommends reviewing each section in sequence. You’ll also find downloadable templates and helpful screenshots throughout to walk you through common workflows.

Step 1: Receive Your Welcome Emails

After Business Development approves your account, you will receive two separate welcome emails to help you begin onboarding

1. Business Development Invitation Email

   Sent by your Lowe’s Marketplace Business Development representative, this message acts as a hand-off and includes:

   • Your unique login link to the Mirakl Seller Portal
   • Your approved product import template
   • Notification that a Seller Management Specialist (SMS) will be reaching out shortly
   
   
2. Seller Management Specialist Welcome Email

   Within 1 business day, your assigned Seller Management Specialist will email an introduction and next steps:

   • Complete Store Account details in Mirakl (all fields + contacts)
   • Confirm your integration method
   • Confirm estimated SKU count
   • Upload required documentation
   
   

Step 2: Log into the Mirakl Seller Portal

Follow the link in your Welcome Email and log in using the credentials provided. Once inside, you’ll land on your Seller Dashboard — the control center for your Marketplace activity.

From here, you can:

• Manage and upload your product offers
• Monitor and process orders
• Set up shipping and returns policies
• Access API settings and credentials

Step 3: Complete Initial Account Setup

Before importing products or connecting to APIs, you must configure your account preferences. Lowe's Marketplace Team recommends completing the following:

Step 4: Upload Your First Products

Once you seller profile is completed in Mirakl and your Store is "Opened", your assigned Seller Management Specialist will email an item onboarding notification that will include:

• A recommendation to start with your top 10 highest GMV items for initial setup and monitoring
• A request to confirm how many items will be included in your initial load
• Best practices for Content Quality, Digital Assets, and impact of product completeness

Next steps to take in your Mirakl back-office:

1. Download the Lowe’s-specific product import template (navigate to "Templates and documents" shown below).
2. Populate the required attributes for your listings in the downloaded template.
3. Upload your completed Excel file directly in the Mirakl Portal.
4. Review any validation feedback or errors, and correct as needed.
5. Once approved, your listings will become eligible for publishing to Lowes.com.

Step 5: Monitor Integration & Progress

During onboarding, the Lowe’s Marketplace Team will work with you to validate the following:

• Product content completeness
• Brand, image, and category accuracy
• Item legal compliance
• Readiness for order flow testing

When your uploaded products pass all Mirakl and Lowe's validations, all of your items will go through the Lowe's buying decision process.

Once a buying decision is made on your items, a Lowe's SKU will generate and become visible to you in your Mirakl Catalog Manager for your items.

Where to Start

Before importing your first product file:

1. Ensure you’ve completed your account setup (shipping, returns, tax), and have been notified your Store is now open for Item Onboarding.
2. Review the Product Import Template downloaded from your Mirakl back-office.
3. Prepare your catalog by populating each required field per product.

Core Required Attributes

Here is an overview of the minimum required fields in the product import process:

Common Mistakes to Avoid

To prevent import errors or item rejection, double-check your file for these common issues before uploading:

• Missing or invalid GTINs (UPC/EAN): Required for all products; must be globally unique and valid format.
• Incorrect or blank categories: Use the official category definitions provided by Lowe’s — don't add your own.
• Duplicate Seller SKUs: Once a SKU is used, reusing it for a different item will result in a conflict.
• Improper formatting: Avoid special characters (e.g., “$, %, &) in any required fields; follow the Core Required Attributes and attributes requirements within Mirakl.
• Placeholder images: Submitting generic or unfinished images will cause rejection. Include final front-facing product imagery.

Data Flow Limitations Between Mirakl and Lowe’s

Not all changes made in Mirakl will sync to Lowe’s systems. Please review these important rules before updating your Store or Catalog data.

Store Data

• Once a Vendor Business Unit (VBU) is assigned, any edits to your Store profile (e.g., address, phone number, legal info) will not update in Lowe’s systems.
• To update Store information in Lowe’s, contact your Lowe's Marketplace point of contact.

Catalog Data

• After items are synchronized from Mirakl to Lowe’s, the following attributes are locked in Lowe’s systems:
  • Model Number
  • Barcode (UPC/EAN)
  • Brand
• Editing these fields in Mirakl will not update the corresponding data on Lowes.com.
• If corrections are required, submit a case to Lowe's Marketplace Support.

What You Can Change

• Price
• Inventory/Stock levels
• Item descriptions and images (subject to Lowe’s moderation policies)

Enrichment Fields (Strongly Recommended)

While not required, enrichment attributes greatly improve your product visibility, conversion rates, and search placement on Lowes.com.

Some recommended enrichment fields:

• Bullet Point Descriptions – Short, scannable highlights of product benefits
• Color / Finish / Material – Helps with filtering and visual merchandising
• Certifications – EnergyStar, UL listing, ADA compliance, etc.
• Installation Details – Useful for categories like appliances or lighting
• Warranty Information – Especially for high-ticket or technical products

Downloadable Templates

You should have received your approved Product Import Template from your Business Development representative as part of your Welcome Email. If not, contact your Seller Management Specialist (SMS) before proceeding.

Common template types:

How to Use Each Template

Product Import Template

Use this to create new product offers on Lowes.com. Each row represents one product (SKU).

• All required attributes must be included (see Section 3).
• Do not change column headers.
• Leave unused optional fields blank, not deleted.
• Save in .csv, .xlsx, or .xml format.

Price Import

Use to update pricing for SKUs that have already been imported.

• Fields typically include: SKU, price, discounts
• Allows promotional adjustments or batch price changes

Offer Import

Keep this updated to reflect your current stock.

• Set `Quantity = 0` to pull an offer offline
• Orders may be canceled or penalized if quantity is outdated

Tips for Successful Uploads

• Always preserve column headers exactly as delivered — do not rename or reorder.
• Save files in UTF-8 format when exporting from Google Sheets or other tools.
• Avoid special characters or formatting (bold, merged cells, etc.).
• Start with a small test batch (e.g., top 10 SKUs) before uploading full catalog.
• Use consistent units of measure across all numeric fields (e.g., inches, lbs).

After Upload: Validate and Fix Errors

1. Upload your file in the Offers > Import section of the Mirakl Seller Portal.
2. If errors exist, Mirakl will generate a downloadable feedback file.
3. Open the file to view row-specific issues and error messages.
4. Make corrections and re-upload the file.

Your Seller Management Specialist can assist in reviewing validation issues, especially during your first few batches.

Strikethrough Pricing Setup

Feature Overview

Strikethrough pricing allows sellers to display a discounted price alongside the original listing price. When active, buyers see both the original and discounted prices — helping highlight savings and drive conversions.

How to Set Up a Strikethrough Promotion

To run a promotion, sellers must include the following attributes in their offer upload:

• Discounted price
• Start date
• End date

Behavior notes

• When the promotional period ends, the original listing price will automatically be displayed again.
• If a start or end date is missing, the discounted price will display without a strikethrough.

Promotion Rules

All promotions must meet the following requirements:

• Must not exceed 30 days from the promotion’s start date.
• Must offer a minimum discount of 5% or $20 off the original price (whichever is lower).
• After 30 days, the item will automatically revert to its original price unless the seller extends the start and end dates.

Example (CSV Import or API Payload)

You can show a sample CSV row or API payload here:

                                    
                                    offer-sku, price, discount-price, discount-start-date, discount-end-date
                                    12345-RED, 99.99, 79.99, 2025-11-01, 2025-11-30
                                    

What is MiraklConnect?

MiraklConnect is an integration hub that links third-party seller systems to the Mirakl Marketplace ecosystem. It offers:

• Direct synchronization of product, offer, price, and stock data
• Support for automated data feeds from eCommerce platforms and PIMs
• Access to a network of pre-integrated partners
• Improved accuracy, less manual work, and faster onboarding

MiraklConnect is optional — but it can be a major time-saver if you manage thousands of SKUs or have a team already working in systems like ChannelAdvisor, Akeneo, or Shopify.

When Should You Use It?

You should consider using MiraklConnect if:

• You have an existing eCommerce system or PIM with complete product data
• You want to automate inventory and price updates
• You’re onboarding a large product catalog (hundreds or thousands of SKUs)
• You already sell on other Mirakl-powered marketplaces

If you’re onboarding fewer than 100 items or prefer a manual approach, Excel template uploads (see Section 4) may be faster and easier to get started.

Getting Started

1. Visit MiraklConnect.com
2. Create an account using the same email tied to your Lowe’s Mirakl Seller Portal login
3. Browse the partner catalog to see if your system is already supported
4. Follow setup instructions for your specific PIM or eCommerce platform
5. Contact your Seller Management Specialist if you need approval or connection guidance

Security & Permissions

• Connections are read/write depending on the partner and configuration
• You must authorize any sync from MiraklConnect before data is pushed to your Lowe’s catalog
• API key management still occurs within the Mirakl Seller Portal

Support for MiraklConnect

MiraklConnect is managed directly by Mirakl. If you run into setup or sync issues:

• Visit the MiraklConnect Help Center
• Submit a support ticket through their interface
• Inform your Lowe’s onboarding contact that you’re attempting integration — they may be able to help monitor your sync

Accessing the Mirakl API

Mirakl offers standardized REST APIs for all sellers across its marketplaces. Lowe’s Marketplace sellers can access the API documentation here: Mirakl Seller API Reference

This page includes:

• Full list of supported endpoints
• Payload schemas and request/response formats
• Status codes and error messages
• Search and filter parameters

Authentication

API access is secured using an API key, which must be included in the header of every request.

To retrieve your API key:

1. Log in to the Mirakl Seller Portal
2. Click your name in the top right
3. Select API Key
4. Click Generate New Key or Copy

What Can You Do With the API?

When to Use API vs. Excel

If your systems already support API integration, the Mirakl API provides greater control and scalability. However, most new sellers start with Excel uploads before transitioning to API workflows.

Testing & Validation

There is no sandbox environment. All API calls are made directly to the live production environment for Lowe’s Marketplace. Be sure to:

• Validate payloads using the API documentation
• Start with small updates (1–2 SKUs) to monitor responses
• Use logging and error checking to catch issues early

If you're unsure where to start, your Seller Management Specialist can help you identify a supported integration model.

Support

For API issues, use the following support paths:

• Mirakl Developer Help Center
• Work with your in-house dev team or integration partner
• Reach out to your Lowe’s Marketplace point of contact for help coordinating with Mirakl if a platform issue is suspected

Marketplace Facilitator Model

Lowe’s operates under a Marketplace Facilitator tax model in many U.S. states. This means:

• In states where this law applies, Lowe’s collects and remits sales tax on your behalf.
• In states where Marketplace Facilitator laws do not apply, you may be responsible for collecting and remitting sales tax yourself.

Your actual tax responsibility may vary depending on:

• The state(s) you are shipping from
• The state(s) you are shipping to
• Whether Lowe’s is required to collect tax for you in those jurisdictions

Nexus and Tax Registration

As a third-party seller, you are responsible for evaluating your nexus obligations (physical presence, economic threshold, etc.) in each state.

Lowe’s does not provide legal or tax advice. However, here are common requirements:

• Registering for a Sales Tax Permit in nexus states (if needed)
• Filing state returns for any sales you are responsible for
• Monitoring state-by-state legislation, which can change frequently

Available Documents and Reports

You may access tax collection information and reports through the Mirakl Seller Portal:

• Order-level tax breakdowns
• Payout reports with tax lines
• Invoices and credit memos for recordkeeping

Your Seller Management Specialist can assist with locating or interpreting these documents but cannot provide tax advice.

Common Questions

Additional Resources

• Lowe’s Marketplace Tax Policy (PDF)
• Marketplace Facilitator State-by-State Guide (PDF)
• IRS Guidance on Online Marketplace Sales

Available Downloads

Content Quality Expectations

You are responsible for ensuring that your product data aligns with Lowe’s marketplace standards. These best practices apply across all templates and categories:

Accurate Titles & Descriptions

• Use complete, consumer-friendly product names
• Avoid filler phrases like “NEW” or “Top Seller”
• Confirm that descriptions match imagery and packaging

Compliant Images & Assets

• Minimum of 3 high-quality images
• White background, product-only — no promotional overlays
• Finalized images only (no placeholders or generic assets)

Attribute Enrichment

• Fill in category-relevant attributes: Finish, Certification, Dimensions, etc.
• These attributes power filtering, faceted search, and on-site navigation
• Higher completion rates lead to better conversion and customer satisfaction

How to Use This Section

• Download each document as needed during onboarding
• Refer to them before uploading your catalog or assets
• Bookmark this page for future reference — specs may evolve over time

Coming Soon

We are currently finalizing the following documents for inclusion on this page:

• Lowe’s Marketplace Seller Agreement
• Product Listing & Content Policy
• Restricted Items List
• Brand Usage and IP Guidelines
• Digital Accessibility Standards (ADA/VPAT)
• Regulatory Compliance Requirements (e.g., Prop 65, PFAS)

General Expectations

In the meantime, please keep in mind the following general policies that apply to all sellers on the Lowe’s Marketplace:

• Do not list prohibited or restricted products (see Prop 65 or PFAS guidance)
• Ensure all images and descriptions are original or properly licensed
• Maintain full compliance with all applicable federal, state, and local laws
• Provide truthful, non-deceptive information in product listings

Lowe’s reserves the right to remove listings or suspend seller accounts that violate content standards or legal policies.

Placeholder Notes

If legal language is required in future updates, this section will also house:

• Required disclaimers
• Policy change acknowledgments
• Formal revision history (version-controlled content)