🧭 PMS Switch Tool Overview
Your BetterSTR account can be connected to only one Property Management System (PMS) at a time. If you move to a new PMS, the Switching PMS tool lets you connect it and bring in its properties without losing the guidebooks you have already built.
🔧 What This Tool Does
The PMS Switch tool lets you:
- Disconnect your old PMS while keeping your guidebook pages
- Move the guides from each old property onto its newly imported property
- Delete the old properties once everything has moved
📅 When to Use This Tool
Use it when you are:
- Moving from one PMS to another (for example, OwnerRez → Hospitable)
- Re-importing all your properties from a fresh PMS connection
If you try to connect a second PMS while one is still connected, the Integrations page shows “You can only be connected to one integration at a time.” Start with Step 1 below instead.
Don’t use Delete integration on your Profile page for a switch. That permanently deletes all your properties, reservations and guides.
🪜 How to Use the PMS Switch Tool
Go to Profile → Switching PMS (under Data in the Sections menu). A progress bar at the top shows the three steps: Prepare, Map guides and Clean up. Steps 2 and 3 stay locked until you have done Step 1.

Step 1 – Prepare for the switch
Click Prepare for switch and confirm. This:
- Renames your properties to start with
TOBEDELETED_(for exampleTOBEDELETED_Seaview Cottage) - Disconnects your current PMS and clears its account details
- Deletes the reservations that came from your PMS
- Keeps your guidebook pages, so you can move them in Step 2
Properties you created by hand in BetterSTR (not imported from a PMS) are left alone, along with their reservations.

When it finishes you are taken to the Integrations page. Connect your new PMS there. Its properties come in, and you switch on the ones you want guidebooks for. If the new connection doesn’t work straight away, log out and back in. Then come back to Switching PMS for Step 2.
Step 2 – Map your guides
The table lists each old TOBEDELETED_ property and how many guide pages it has. For each one:
- (1) Pick the matching new property from the Map to New Property dropdown.
- (2) Click Map on that row. All the guide pages on the old property move to the new one, and the table refreshes.
- (3) When every property is done, click Complete Mapping to go to Step 3.

Tips:
- Map one row at a time: each Map button only moves the row it is on.
- Property names can differ between PMS providers, so check you have picked the right one.
- After mapping, the old property shows 0 guide(s) and the guides appear under the new property.
Only the guide pages move
Mapping moves the guidebook pages. Anything set on the old property itself is not copied across, so set these up again on the new property:
- Property settings on Edit Property
- Android TVs, WiFi setup, map locations and upsell products linked to the old property
Each new property has its own guide link, so update any links or QR codes you have shared or printed for a specific property.
Step 3 – Clean up old properties
- (1) Check the Properties to be deleted list. It shows each old
TOBEDELETED_property and how many unmapped guides it still has. Every one should say 0 unmapped guide(s). - (2) Click Delete all old properties and confirm. The old properties and any guides still on them are deleted, and you are taken to your Properties page.

⚠️ Warning: This can’t be undone. Make sure every guide you want to keep has been mapped before you click delete.
📝 Important Notes
- Do the steps in order: Prepare, connect your new PMS, Map guides, Clean up.
- Always finish mapping before deleting old properties.
- Running Step 1 again won’t add a second
TOBEDELETED_prefix. - Reservations from your new PMS sync in on their own once it is connected.
💬 Need Help?
If anything looks wrong during the switch, contact Support before Step 3. Once old properties are deleted, they cannot be recovered.