Use special #mos URL fragments to trigger specific sections of MediaOS embedded tools on your website. These actions let you link users directly to areas like Account Info, Newsletters, Bookmarks, Login, and more — without any extra coding.
Why Use URL Actions? #
MediaOS URL Actions allow you to link users directly to specific parts of the embedded MediaOS tools, whether that is to view purchases, manage subscriptions, or open the login screen. This feature is especially useful for creating menus that link to areas like My Account, My Newsletters, or Login, as well as placing buttons or calls-to-action (CTAs) inside newsletters and campaigns. URL Actions also support guided user flows, such as prompting registration or encouraging newsletter sign-ups. By using URL Actions, you can significantly improve the user experience by reducing friction and ensuring users land exactly where you want them.
Tip: You can use these fragments in any URL on your site where MediaOS is embedded and initialized.
Supported #mos Actions URL Actions #
Use these fragments at the end of your URLs to trigger specific embedded sections:
URL Fragment | Opens/Triggers |
---|---|
#mosAccount | Opens the My Account section. |
#mosNewsletters | Opens the Newsletters preferences. |
#mosBookmarks | Opens the user’s Saved Bookmarks. |
#mosPurchases | Opens the Purchase History screen. |
#mosMemberships | Opens the Memberships panel. |
#mosSubscriptions | Opens the Active Subscriptions list. |
#mosBusinessListings | Opens the user's Business Listings. |
#mosEventListings | Opens the user's Event Listings. |
#mosRegister | Triggers the Registration modal. |
#mosLogin | Triggers the Login modal. |
#mosLogout | Logs the user out immediately. |
#mosPN | Triggers a push notification permission prompt (requires OneSignal setup). |
Note: These only work if the MediaOS embed script is properly included on the page and initialized. If a designated page is specified for things like checkout, login or register, the user will be redirected to those pages.
Example Usage #
You might place a link like this in a navigation menu:
<a href="https://yourdomain.com/#mosNewsletters">Manage Newsletters</a>
Tip: If users are not logged in, MediaOS will prompt them to log in before showing personalized account sections.
Troubleshooting #
If nothing happens when a URL Action is clicked, there are a few things to check. First, confirm that the page includes the MediaOS embed script, as this is required for the action to function. Make sure the script has fully loaded before the user clicks the link or reloads the page with the hash in the URL. Also, ensure you are not testing the action on a page that blocks JavaScript execution or interferes with URL hashes, as this can prevent the URL Action from working properly.
Tip: If your site uses a single-page app or a JavaScript router, make sure your framework does not strip or ignore the # fragment in the URL.