Who Is This For?
StoreHub merchants currently using the old iOS StoreHub POS app who need to switch to the new version.
Overview
The old iOS StoreHub POS app is being phased out. The new app includes features like takeaway support, floor plan table layout, product management from POS, and improved printer support.
This article walks you through both migration methods (manual and in-app guided), migrating your table layout, and setting up the new app after migration.
Before You Begin
Your iPad must be 7th Generation or above, running iOS 13.1 or newer.
Complete all open orders and close the current shift before starting migration.
Tap the 'Sync' button multiple times on your old app to make sure all sales data is uploaded.
We recommend performing the migration after business hours to avoid service disruptions.
The migration process takes about 5 minutes.
Step-by-Step Guide
Feature Differences Between Old and New App
Before migrating, review what the new app offers compared to the old one.
Features | New App | Old App |
Takeaway support | ✅ | ❌ |
Floor plan table layout (create on POS) | ✅ | ❌ |
Manage and add products from POS | ✅ | ❌ |
Edit product layout on POS | ✅ | ❌ |
Cancel QR orders on POS | ✅ | ❌ |
Scan QR on POS to contact support | ✅ | ❌ |
Improved printer error support | ✅ | ❌ |
Pay Later with add-on orders from POS | ✅ | ❌ |
Kitchen docket: add-on/modifiers print line-by-line | ✅ | ❌ |
Barcode scanner support (Socket S700 / Socket Mobile) | ✅ | ✅ |
Printer support | ✅ | ✅ |
Merge, split, and change table orders | ✅ | ✅ |
Multiple Register Sync | ✅ | ✅ |
Customer-Facing Display | ✅ | ✅ |
Check product inventory and out-of-stock warning | ✅ | ✅ |
Print A4 receipt | ✅ | ✅ |
Enter Tax ID for customer on POS | ✅ | ✅ |
K-Bank QR Pay (Thailand) | ✅ | ✅ |
BIR requirements for retail (Philippines) | ✅ | ✅ |
Option 1: Migrate Using the In-App Guide (Recommended)
1. Download the new StoreHub POS app from the App Store first. Search for 'StoreHub Point of Sale (NEW)' with the darker orange logo.
2. Open your old StoreHub POS app and tap the 'Find Out How to Migrate' button.
3. Tap the 'Migrate Now' button to start the guided migration.
4. The system checks if your printer models are supported by the new app. After confirming, tap 'Next'.
Note:
Refer to the Supported Printers section below if you are unsure about your printer model.
The system checks for unpaid orders. If there are open orders, complete them first before proceeding.
The system checks if your shift is closed. If it is still open, close it first, then restart the migration process from step 2.
Your data is being saved to transfer to the new app. Wait for this process to complete.
5. Tap 'Start Migration' to begin transferring your data to the new app.
6. The new app will launch automatically. Wait for the migration to complete.
7. Log in to the new StoreHub POS app. You have successfully migrated.
Option 2: Migrate Manually via BackOffice
Use this method if you do not have access to the in-app migration guide.
1. In your BackOffice, go to 'Settings', then tap 'POS Register'.
2. Select your existing iPad register, scroll down, and tap 'Deactivate'.
3. On your iPad, go to the App Store and download the new 'StoreHub Point of Sale (NEW)' app.
4. Open the new app and sign in using your account ID and password.
5. Select the register to activate.
6. When prompted, allow app permissions such as sending notifications, using GPS, and finding other devices on your local network.
Set Up the New App After Migration
After you sign in and activate your register on the new app, finish any remaining setup in the app (for example printers and receipt options). Menus and labels can change between app versions, so use the live Settings screens on your device. For printer pairing, roles, and tests, see this article.
Migrate Your Table Layout (F&B)
If you had a table layout set up on the old iOS POS app, you can migrate it to the new app instead of creating a new one.
Notes:
Migrating from the old iOS POS to Android POS is not possible if a table layout has already been set up in the Android POS system.
There must be no existing table layout enabled on the new iOS POS app or Android POS.
Table layout must be enabled on the old iOS POS app.
There are three ways to migrate your table layout:
Method 1: Re-Activate Register
1. After downloading the new iOS POS app, deactivate the register in BackOffice.
2. Re-activate the register using the new iOS POS app.
3. If successful, a pop-up will appear on your POS saying 'Your table layout is now migrated. Edit Table Layout Now.'
Method 2: Sync in POS
1. In the new iOS POS app, go to 'Settings', then tap 'Table Layout'.
2. Toggle on 'Enable Table Layout'.
3. Tap the 'Sync' button.
Refer to this article for full steps on how to enable table layout.
Method 3: Edit Table Layout
1. In the new iOS POS app, go to 'Settings', then tap 'Table Layout'.
2. Tap 'Edit Table Layout'.
3. A pop-up will confirm that your table layout has been successfully migrated.
Supported Printers
Brand | Model |
Xprinter | CP-Q6+, CP-Q3s, CP-Q3x, XP-Q80i, Q260, Q80I, CP-Q2+, CP-Q3, CP-Q3X, CP-Q3S, XP-T260L, Q838L |
STAR | TSP100, TSP143, TSP600, TSP650, TSP700, TSP654, mPOP |
VPOS | VP-Q3 |
Bixolon | SLP DX220 |
AirPrint | HP Ink Jet |
Note:
To check your printer model, flip your printer over and look for a label sticker with the model name printed on it.
Troubleshooting
Issue | Solution |
Migration button does not appear in the old app | This feature is for whitelisted merchants only. Use Option 2 (manual migration via BackOffice) or contact the Care Team via Live Chat. |
Open orders prevent migration | Complete all open orders first, then close the current shift. Restart the migration process. |
Shift is not closed | Close the current shift from the old app, then restart the migration process. |
Table layout did not migrate | Make sure there is no existing table layout on the new app or Android POS. Try Method 2 (Sync) or Method 3 (Edit Table Layout). |
Printer not working after migration | Re-pair and re-assign printers in the new app using the printer section in Settings. See here for the details. |
Data appears to be missing after migration | Make sure you tapped 'Sync' multiple times on the old app before starting the migration. Contact StoreHub Support if data is still missing. |
FAQs
1. Will I lose my sales data when I migrate?
No, as long as you sync your old app before migrating. Tap the Sync button multiple times to make sure all data is uploaded to BackOffice.
2. Can I go back to the old app after migrating?
The old app is being phased out and will no longer receive updates or bug fixes. We recommend staying on the new app.
3. How long does the migration process take?
About 5 minutes. We recommend doing it after business hours to avoid disruptions.
4. Do I need to set up my printers again after migrating?
Yes. Go to Settings, then Printer in the new app to search, assign, and test your printers.
5. Can I migrate my table layout from the old iOS app to an Android POS?
Only if no table layout has already been set up on the Android POS. If one already exists, the migration will not work.
Need Help?
Contact StoreHub Support via live chat in your StoreHub app or email [email protected].
Was This Article Helpful?
Let us know below or contact support for further assistance.