You can add Spotify playlists to any section of your guidebook using Custom Elements. Don't have your own playlist? No problem. Spotify has thousands of playlists you can choose from to create the right vibe.
Table of contents:
Video: How to add a Spotify playlist to your Touch Stay guidebook
Step by step: How to add a Spotify playlist to your Touch Stay guidebook
Open Custom Elements and click New Custom Element:
New Hub: Account library → Custom Elements in the left sidebar (multi-account owners: Content Hub → Custom Elements)
Legacy Hub: Settings → Custom Elements
Select Spotify Playlist as the Third Party Service. An Element code name will be generated. This is the code that you will insert in your guide where you want the Spotify playlist to show. You can change the name to whatever you wish to make it easier to identify each custom element you add. Only letters, numbers, underscores, or hyphens can be used - no special characters or spaces.
Next, copy the Spotify playlist link for your playlist. Go to your playlist on Spotify. Click the 3 dots menu, click Share.
Click Copy link to playlist, paste it into the Spotify playlist link box in Touch Stay and click Save.
To insert the Spotify playlist into your guide, open the topic you want to add it to (new Hub: open the guidebook and go to the Guidebook Content tab; legacy Hub: Content Hub). Put your cursor where you want the Spotify playlist to appear. Click Custom Element in the editor toolbar, select the relevant element code name from the dropdown and click Insert. Then save the topic (new Hub: Save Changes; legacy Hub: Save).
This will place your custom element code into your topic content, and when you preview the guide it will be replaced by your Spotify playlist.
Trouble Shooting FAQs
My link isn't being accepted when creating my custom element. What should I do?
If your link isn't being accepted, then the most likely reason is that it's the wrong link option. Spotify offers a few sharing options, and we need the basic share link to your playlist (starting with https://open.spotify.com/playlist/), as shown in the screenshots above. If this still doesn't work, or you can't find it in your Spotify account, then please contact support and send us a screenshot of the Spotify playlist share options that are available to you.
My playlist doesn't display fully or has lots of empty space beneath it. What should I do?
The playlist will be added to your guide using what's known in web development as an iframe. This technique creates a window in your guide to the Spotify playlist. However, the window isn't able to detect the size of the source playlist, and you may wish to adjust the height of the window to better match your playlist size. Open Custom Elements (see the path above), use the 3 dots menu next to the element and select View/Edit, then adjust the Standard element height. You may find it useful to have your guide preview open in a separate tab so you can refresh the page after changing the height in case it needs further adjustment.
Can I have a different variation of the playlist for each of my guides?
On the legacy Hub, yes. This could be useful if you have a slightly different track listing for each property. Go to Guides and click the name of the guide. Scroll down to the Guide Custom Elements card at the bottom of the Guide details page and click Edit. In the Edit Custom Elements (this guide only) window, paste the playlist link for this guide and adjust the element height as needed. This card only appears if you have more than one guide and at least one Custom Element.
The new Hub doesn't have a per-guide version yet. It has no screen to see or edit per-guide values, but any you already set in the legacy Hub still apply to your guests. To change them, switch back to the legacy Hub. Note that if you're an owner, admin or team admin, switching to the legacy Hub also turns Guidebook 2.0 off.
Will the full playlist play in the guide?
Guests can play a short preview in the guide. To listen to the full playlist, they'll need to sign up for Spotify or open the app if they already have it.
Because of music rights, we can't play the full list of songs directly in the guide.
If the guest already has the Spotify app on their device, they'll be redirected there to keep listening to the complete playlist.
🤝 Need help?
Our Fin AI assistant is available 24/7 and typically responds in under 10 seconds. If Fin isn't able to solve your issue, our support team will take ownership of your case from there.
You can also reach out to our team at [email protected], and we'll be happy to help.







