> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Setup and configuration
Here's how you set up the Shopify POS integration with Engage.
This article has two main sections:
1. Getting your Shopify app to work for the POS integration
2. Setting up the Shopify mobile POS app (if you are using it)
## POS configuration of Shopify app
This involves some extra configuration added to an already functioning implementation of the Voyado Engage app for Shopify.
Complete the e-com configuration and then return here for the extra configuration needed for the POS integration.
Then (or if your e-com configuration is already done) go through the steps below. There are the additional configuration steps you'll need to get the POS integration working with your "Voyado Engage" app in Shopify.
There are three things you'll need to adjust in the app settings:
1. Store to Country Mapping
2. Promotions & reward voucher sync
3. Data import
### 1 - Store to Country Mapping
In this step, you'll connect your stores in Engage to the location in Shopify, using the second option on the panel, **Shopify POS location**. The values for the first option, **Shipping country**, will already exist if you have already done the e-com configuration.
If, however, you're doing the e-com and POS configurations at the same time, you can take these two tasks in any order.
If you've *not yet* filled in anything in this panel, it'll look like this:
If you *have* already filled in the shipping country values, the panel will look like this:
In both cases, select "Add mapping" to get started.
Now select the second option, "Shopify POS location":
You will see two drop-downs. The first has all your Voyado Engage stores, the second your Shopify locations.
Only Engage stores of type "RETAIL" will appear in the "Voyado store" list.
Select the Shopify location for each of your Engage stores.
Then select "Save".
### 2 - Promotions & reward voucher sync
To use promotions and vouchers from Engage in the Shopify POS app, you'll need to activate that here. Promotions and vouchers from Engage are handled as different kinds of discounts in Shopify.
"Enable promotion sync" allows you to use Engage promotions in the Shopify POS app.
"Enable loyalty voucher sync" allows vouchers to be created in Engage and used in the Shopify POS.
To use promotions and vouchers in the basic e-com integration, you'll need to have enabled the app embed block. This, however, *does not apply* for the POS integration, where selecting the check-boxes in the panel is enough.
For details on using promotions and vouchers in the POS integration, see here:
### 3 - Data import
This allows you to migrate customers and orders from your Shopify account to Engage through the Voyado Engage app, enabling you to start your Engage journey with your data already in place.
If you have the Shopify POS integration with Engage, this step will migrate that data as well.
There are two cases to consider here:
Here, you'll select the "Import customer data" options and then hit "Submit". This will migrate all your Shopify customers (and POS customers, if applicable) to Engage. If they don't already exist in Engage, they will be created there as contacts.
If a migrated customer already exists in Engage, the app will not update their data, but just fetch the contactId reference from Engage and store that in Shopify.
This app can also handle customers that were created only in Engage or imported there through other channel, such as a CSV file import, or via some other platform. This is important in the next step when migrating orders.
"Import customer data" will fetch and store the contact ID of any customer who was created in Engage outside of the app.
This starts a migration of Shopify orders, both purchases and returns, to Engage (and POS orders, if applicable). For this to work, the customer who made the order must already exist as a contact in Engage. That's why you'll always select the "import customer data" option here. Doing this ensures that customer data is synced before orders data is migrated (as there always needs to be a customer to connect an order to).
If, for example, a customer exists in Engage but not in Shopify, the app, when matching orders to customers, will fetch the contactId reference from Engage and store it in Shopify. This is relevant for any customer data imported into Engage outside of the app.
The order data option allows you to specify "Start date" and "End date". Then you will only sync those orders created inside that time window. Hit "Submit" to start the migration.
When doing an order data migration, the app will process the data in this order: customer import first, and then the order import.
The migration of customers and orders can activate automations for those customers that exist in Engage. If you have automations set up to trigger on "New contact registered", "Product purchase" or "New return", you should deactivate these during this migration.
## Shopify POS mobile app
This is the procedure for installing and using the Voyado Engage POS app for Shopify on your mobile device.
The Shopify POS app can be downloaded from the Google Play Store or the App Store depending on what mobile device you want to use as your Shopify POS.
Open the app on your device and log in with your Shopify account credentials. You'll need to enter a PIN code to allow fast unlocking of the app. Then go to the "Home" screen, which will look like this (here, the app is in Dark mode, in basic mode the background is white).
You'll now need to install the connection to Engage. Select "Add tile" and then "App". Here, search for the Voyado Engage POS app and install it. Once that's done, the "Manage Voyado discounts" tile will appear.
The installation is now complete.