> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.puppetvendors.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Migrating from Vendor Consignment to Puppet Vendors

If you are considering migrating from Vendor Consignment to Puppet Vendors, you are in the right place. 

This guide will provide you with the necessary steps to make the transition process as smooth as possible. 

|| Before starting, confirm that you have **Puppet Vendors** installed. If not, [install Puppet Vendors from the Shopify App Store by clicking this link.](https://apps.shopify.com/puppet-vendors)

The guide below walks you through the process of migrating your

1. Existing Vendors
2. User Accounts (these are user emails linked to any vendor primarily used by vendors to log into the portal)
3. Payouts
4. Historical orders
5. Products


### Step 1: Migrate Existing Vendors

(1) Visit the **Vendor Consignment** app in your Shopify admin and click on the **Vendors** menu at the top of the screen. (2) Click on the export button. (refer to Image 1)

The file should contain a list of your **vendors** along with their **commissions rate**, **pending commissions**, **total commissions paid**, **total amount earned**, and payout **PayPal email** for each of your vendors.

![Image 1: Export vendors](https://storage.crisp.chat/users/helpdesk/website/cf9b185a0b087000/screenshot-2024-08-06-at-14520_19852v4.png)


### Step 2: Migrate User Accounts

(1) Navigate to the **Accounts** menu at the top of the screen. (2) Click on the export button. (refer to Image 2)

The file should contain a list of your **vendors** along with their associated **email addresses** which are used for logging into the vendor portal.

![Image 2: Export accounts](https://storage.crisp.chat/users/helpdesk/website/cf9b185a0b087000/screenshot-2024-08-06-at-15062_17fc6t4.png)


### Step 3: Migrate Payouts

(1) Navigate to the **Payouts** menu at the top of the screen. (2) Click on the export button. (refer to Image 3)

The file should contain a list of your **historical payouts** by vendor and amount along with a payout note for each payout. The payouts will be grouped by vendor into a single payout when moving to Puppet Vendors.

![Image 3: Export Payouts](https://storage.crisp.chat/users/helpdesk/website/cf9b185a0b087000/screenshot-2024-08-06-at-15125_1w8gmgi.png)

|| Once you have exported all the three CSV files (vendors, accounts, payouts) following steps 1 to 3, please share them with our support team so our team can begin the migration for you.

### Step 4: (Optional) Historical orders and products are automatically imported from your Shopify store automatically during app installation.

[Follow this guide to import historical orders from a selected date.](/en/article/how-to-import-historical-orders-1q1bx85/)