> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/operations/suppliers/add-a-supplier.md).

# Add a Supplier

Suppliers connect your procurement to production planning. Configure supplier details, lead times, and preferences to optimize replenishment decisions and streamline ordering.

## Watch: Creating Suppliers with Mo

Setting up vendors for the first time? This walkthrough shows Mo building your supplier list from a spreadsheet — the preview it shows first, and what it does with names it already recognizes.

{% embed url="<https://youtu.be/-hzp80Fa0IE>" %}
Create Suppliers with Mo
{% endembed %}

### Suppliers List

Click **Suppliers** from the Moselle menu to view all suppliers. The list displays:

* Name
* Country
* Incoming GMV
* Active Orders
* Catalog Last Updated

Click **Add Supplier** in the top right corner to create a new supplier.

### Create a Supplier

1. Click **Add Supplier**
2. A pop-up will appear - enter:
   * Name
   * Country
   * Currency
3. Click **Next**, then answer a short set of guided questions:

   * **Do they manufacture your products?** Choose **No, we buy finished goods** and you're done — this creates a **Finished goods supplier**. Choose **Yes, they make product for us** to continue.
   * **Who supplies the components they build with?** Choose **We do, our components go to their facility** and you're done — this creates a **Consignment manufacturer**, with inventory tracking turned on automatically. Choose **The supplier, they source their own components** to continue.
   * **Do you track inventory at their facility?** Choose **No, their stock is a black box** and you're done — this creates a **Turnkey manufacturer** with tracking off. Choose **Yes, track stock sitting at this supplier** to continue.
   * **How do you want to track their inventory?** Choose **Create a new warehouse** (named after this supplier, tracked from day one) or **Link to an existing warehouse** (its stock and history become this supplier's facility).

   The dialog shows the resulting supplier type — **Finished goods supplier**, **Turnkey manufacturer**, or **Consignment manufacturer** — as soon as your answers determine it.
4. Click **Save Changes**

You'll be taken to the Supplier Details page where you can add additional information.

{% hint style="info" %}
These answers decide how lead times work for this vendor and whether they can hold your stock, so they're worth getting right. You can change them later from the Supply Chain canvas.
{% endhint %}

{% content-ref url="/pages/RPnjxVQVrygjJyKHTe43" %}
[Supplier Types](/operations/suppliers/supplier-types.md)
{% endcontent-ref %}

You can also create a supplier from the **Supply Chain** canvas (**Operations > Inventory > Supply Chain**) using the **+** on the **Suppliers** heading — it opens the same dialog.

### Import Suppliers with Mo

{% hint style="info" %}
**Quick Answer:** Attach a supplier list (CSV or Excel) in any Mo chat and say something like *"Here are our suppliers, please import them."* Mo previews what will be created, updated, or skipped — click **Add suppliers** to import. Takes about 2 minutes.
{% endhint %}

1. **Attach your file** in any Mo chat and tell Mo what it is, e.g. *"This is our full supplier list, some are new."*
2. **Review the preview.** Mo shows how many suppliers will be **created**, **updated**, and **skipped**. Open the detail view to see flagged rows (like an unrecognized country), fix your file, and re-upload if needed.
3. **Click Add suppliers.** Nothing saves until you do. The import runs in the background and Mo emails and notifies you in-app when it's done.

{% hint style="warning" %}
Mo matches rows to existing suppliers by **name**: a match updates that supplier, anything else creates a new one. Updates only change the columns you fill in — a blank cell won't clear a saved value.
{% endhint %}

{% hint style="info" %}
**Ask for one thing per message.** If your file also has pricing in it, don't ask Mo to import the suppliers and their prices at once. Import the suppliers first, then send a second message asking for the catalog — the same file works for both, with no edits.
{% endhint %}

{% content-ref url="/pages/WCsX337cwTs46Xw0Ehqs" %}
[Supplier Catalog](/operations/suppliers/supplier-catalog.md)
{% endcontent-ref %}

#### What Columns Can the File Include?

Column order doesn't matter, and unrecognized columns are ignored.

| Category                | Fields                                                                                         |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| Identity **(required)** | Name                                                                                           |
| Contact                 | Email, phone number, contact name, address, city, state, postal code, country                  |
| Settings                | Currency, payment terms (days), average lead time, preference ranking, supplier type, archived |

**Country** and **currency** must match a value Moselle recognizes or they're left blank. **Payment terms** and **average lead time** must be zero or a positive number.

{% content-ref url="/pages/bhnbOdyzHJU16Tc1oHKc" %}
[Upload Your Files to Mo](/mo/tips/upload-your-files-to-mo.md)
{% endcontent-ref %}

### Supplier Details Page

The Supplier Details page has four tabs:

#### Overview Tab

**Supplier Details**

| Field        | Description             |
| ------------ | ----------------------- |
| Name         | Supplier name           |
| Email        | Supplier contact email  |
| Phone Number | Supplier contact phone  |
| Address      | Physical street address |
| City & State | City and state location |
| Country      | Country location        |
| Postal Code  | Zip or postal code      |

**Supplier Settings**

**Lead Time (days)** Adjusting the lead time will influence how replenishment automation is calculated when planning your production schedule. \[Learn more]

**Preference Ranking** Moselle will prioritize suppliers with a higher ranking in replenishment automation if other criteria are equal.

**Notes** Add additional notes about the supplier.