# Understanding BurgerPrints' auto mapping feature
### Overview
This article explains how Auto Mapping works and how to set it up for your store.
It is for users who connect stores (Shopify, Etsy, TikTok Shop, WooCommerce, etc.) and manage synced orders in BurgerPrints.
Auto Mapping helps you automatically assign SKU and design files to new orders based on your previous mapping history, reducing repetitive manual work.
To use this feature, your store must be connected and you need at least one successfully paid order to create mapping history.
### About Auto Mapping
#### What is auto mapping?
Auto Mapping is a feature that automatically fills missing SKU and design file information for synced orders.
When an order syncs to BurgerPrints, it requires:
* A SKU - the specific product variant (size, color, style)
* A design file - the print file that goes on the product
If either is missing, the order stays in **Incompleted** status.
**Auto Mapping** solves this by using your past mapping data to fill in missing information automatically.
**Mapping data includes:**
* Manual mapping
* Bulk matching
* Previous auto mapping
* Updates during fulfillment
The system always uses the most recent valid mapped order as the reference.
#### What you need before auto mapping works
**Auto Mapping** runs automatically when a new order syncs in and meets all conditions below:
* Your store is connected and active
* The order is in **Incompleted** status
* The order item is missing SKU or design file
* A previous order exists with the same store and matching reference SKU
* That order was successfully paid (excluding refunded orders)
System validation before mapping:
* SKU is valid
* Design file is valid
* SKU is in stock
If no valid mapping history exists, the order remains **Incompleted** and requires manual mapping.This ensures the system only learns from orders that went through production successfully, not cancelled or problematic ones.
#### SKU mapping vs. design mapping
Auto Mapping always maps SKUs automatically. Design files depend on your store settings.
* Enable design mapping: system maps SKU and design file
* Disable design mapping: system maps SKU only
{% hint style="success" %}
**Note**: The system copies the design file from your most recent paid order.
{% endhint %}
#### What if you sell both types of products?
Some stores sell both standard and personalized products. For example, the same T-shirt template but with a different name printed for each order.
There is no single correct setting. Choose based on how your orders typically work.
**If most orders use the same design file:**
* Enable design mapping
* Update the design file only for orders that require customization before payment
**If most orders use different design files:**
* Disable design mapping
* The system still maps SKU automatically
* Upload the design file for each order
**How to decide:**
Choose the option that reduces the most manual work in your workflow.
**Important:**
* If you enable design mapping, the system copies the design file from the most recent mapped order.
* If you change the design in your store, you still need to update the design manually in the order when needed.
{% hint style="success" %}
**Note:** You can update this setting anytime from **Stores**. Changes do not affect orders that are already mapped.
{% endhint %}
#### How auto mapping works
When a new order syncs:
1. The system checks if the order is **Incompleted** and missing SKU or design
2. The system checks mapping history for the same store and reference SKU
3. If a valid record exists, Auto Mapping applies
4. If not, the order stays **Incompleted** for manual mapping
#### What happens after auto mapping
After Auto Mapping runs:
* The system assigns:
* SKU only, or
* SKU + design file (based on your setting)
* Order status updates:
* Fully mapped → **Unpaid**
* Still missing data → remains **Incompleted**
* A timeline entry appears in order details:
* Order auto-mapped SKU \[short code] referenced from Order \[ID]
* Or with design file if applied
* The mapping data is saved for future orders after the order is successfully paid
#### Auto Mapping with Auto Fulfillment
If you enable both **Auto Mapping** and **Auto Fulfillment**, orders can move forward automatically without manual action.
When a new order syncs:
* **Auto Mapping** fills in SKU and (optionally) design file
* If the order has all required information, status changes to **Unpaid**
* If auto fulfillment is enabled and the order is paid, the order moves to the next production stage automatically
**Important:**
* This only works if all required information is correctly mapped
* If design mapping is enabled, the system uses the design from the most recent mapped order
* For personalized products, review the design before payment to avoid incorrect production
### How To Set Up Auto Mapping
**Step 1:** Go to **Stores** on your Dashboard.
**Step 2:** Find your connected store, then click the Auto Mapping Setting icon next to it.
**Step 3:** In the popup, choose your design mapping preference.
* Check Apply design from mapping history to map both SKU and design file automatically
* Leave it unchecked to map SKU only
**Step 4:** Click Save. A confirmation message appears on your screen.
### Tips and Best Practices
* Edit before you pay. Auto-mapped orders are not locked. Go to **Orders**, open the order, and update the SKU or design file before paying.
* Editing does not change your history. Changes you make before paying only apply to that order. Your mapping history updates only when an order is paid.
* Each store has its own setting. If you run multiple stores selling the same product, set up **Auto Mapping** separately for each store.
* Keep your design files active. If a design file is deleted, **Auto Mapping** fails and the order stays **Incompleted**.
### Frequently Asked Questions
1. **Why is my order still Incompleted after auto mapping?**\
This happens when there is no mapping history yet, the SKU is out of stock, or the design file has been deleted. Open the order and fill in the missing information manually.
2. **Does my first order ever auto-map?**\
No. The first order for any product always requires manual mapping. After you pay that order, it becomes the mapping history for all future orders with the same product.
3. **Can I use the same mapping history across multiple stores?**\
No. Mapping history is store-specific. An order from your Etsy store does not apply to your Shopify store, even if the product is the same.
4. **What if the fulfillment facility changes my SKU or design file during production?**\
The system saves those changes automatically. Future orders use the updated information as the new mapping reference.
### Related Articles
* [How to connect your Shopify store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-shopify-store-to-burgerprints.md)
* [How to connect your TikTok Shop US to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-tiktok-shop-us-to-burgerprints.md)
* [How to connect your WooCommerce store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-woocommerce-store-to-burgerprints.md)
* [How to connect your Walmart store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-walmart-store-to-burgerprints.md)
* [How to connect your Etsy store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-etsy-store-to-burgerprints.md)
* [How to connect your BurgerShop store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-burgershop-store-to-burgerprints.md)
* [How to integrate Order Desk with BurgerPrints](/integrations-and-store-connections/store-connections/how-to-integrate-order-desk-with-burgerprints.md)
* [How to create an order on BurgerPrints](/orders-production-and-fulfillment/orders/how-to-create-an-order-on-burgerprints.md)
---
# 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://help.burgerprints.com/integrations-and-store-connections/store-connections/understanding-burgerprints-auto-mapping-feature.md?ask=
```
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.