How to embed an Apple Music playlist in your guide

4 min. readlast update: 03.26.2024

You can add Apple Music playlists to any section of your guidebook using Custom Elements. Don’t have your own playlist? No problem. Apple Music has thousands of playlists you can choose from to create the right vibe.

Video: How to add an Apple Music playlist to your Touch Stay guidebook

Step by step: How to add a Apple Music playlist to your Touch Stay guidebook

New Custom Elements can be created from the "Custom Elements" tab of the Account page. Use the New Custom Element option.


Next, select Apple Playlist as the Third Party Service. This will prepopulate a Custom element code name but you can change this to something more descriptive if you prefer. This is the short code that you will ultimately insert into your topic content where you want the playlist to show.

You now need to copy the share link for your playlist. This can be found in Apple Music under the 3 dots menu for your playlist and within the Share options. Use the Copy link to playlist option and then paste into the Apple Music playlist embed code box in your Touch Stay Custom Element and click Save.

Head to Content Hub and find/add the topic you wish to include your playlist within. In the text entry box toolbar for the topic there is an option for Custom Elements. Place your cursor where you would like the playlist to be present in the topic, it can be used standalone or have regular topic content (regular text or images) before or after. Click the Custom Elements option in the toolbar and then select your custom element code name from the dropdown and click Insert.




This will place your custom element field code into your topic content and when you preview the guide it will be replaced by your Apple Music 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. Apple Music offers a few sharing options and we need the most basic share link to your playlist as shown in the screenshots above. Double check you are using the basic direct link for your playlist. If this still doesn't work, or you can't find it in your Apple Music account, then please contact support and send us a screenshot of the Apple Music 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 wil 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 Apple Music 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. This can be done by editing the custom element from the Custom Elements tab of the Account page. Use the 3 dots menu and select View/Edit, then adjust the height value accordingly. You may find it useful to have your guide preview open in a spearate 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?

Yes, you can set a different value for the link for each guide in your account. This could be useful if you have a slightly different track listing for each property or van. The guide specific value of any custom element can be added from the Guide Details tab for each guide. 

Towards the bottom of the tab is a Guide Custom Elements section, use the Edit button and within here any value for the link and height that you set will apply to this guide only. Note this option is only available if you have more than 1 guide in your account.



Was this article helpful?