Summary
The portal switcher, aka the portal jumper, lets you move from one portal to another within in your realm.
Sub-portals are available depending on your LearnUpon plan.
When your realm includes more than 1 portal, the portal switcher icon appears in the top navigation bar of your portal. In LearnUpon, a main portal with sub-portals connected to it are called a realm.
The following screenshot shows the portal switcher next to the user profile icon, in the top navigation bar.
Selecting the switcher displays the portals where you have an account in alphabetical order, and includes a search option.
Background
The following articles provide context for when your organization would set up multiple portals, and how to add learners and other user types to more than 1 portal.
- Create and manage sub-portals
- Portal setup: create admin accounts
- Sub-portals: adding users to more than 1 portal
Prerequisites to access the portal switcher
You can access the portal switcher when:
- you have an active account in more than 1 portal
- the portals are not white-labelled, aka not customized. The LearnUpon name appears as part of the URL
For security reasons, the portal switcher does not appear when:
- one or more of the portals is white-labelled, so LearnUpon's name does not appear in the URL
- you log in using SSO (single sign-on), like SAML or SQSSO
See:
Example 1: using portals with the switcher
Agnes logs directly into yourportal1.learnupon.com (Documentation demo) through the portal login page.
Agnes is also a member of the yourportal2.learnupon.com (Learning path) in your realm. Agnes can navigate seamlessly to yourportal2.learnupon.com portal through the portal switcher.
The following screenshot shows some sample sub-portals in an example realm.
Example 2: accessing a portal with SSO
When your organization sets up SSO on a portal, Agnes can access the portal without going through the login page. When she logs in to her organization’s identity provider like Okta, GSuite, Salesforce or similar, she has automatic access to the portal, without re-entering her email (or username) and password.
An SSO authentication happens outside of LearnUpon. Agnes is authorized by the identity provider, and her login session is only valid in a single portal, and does not have access to the portal switcher.
Tip: To retain access to all your portals through the portal switcher, log in through the LearnUpon login page, and add users/sign_in?no_sso=true suffix to your portal URL.
Example 3: using a white-labelled portal
Agnes logs into a customized portal, that doesn’t use the LearnUpon name in its URL, like training.yourorganization.com .
Login sessions in white-labelled portals are unique to each portal, so the portal switcher does not appear.
Note: To keep access to the portal switcher and to the Support Center, LearnUpon recommends that admins continue to use the original yourorganization.learnupon.com URL.
Users' accounts and two-factor authentication (2FA)
Top-level portals and sub-portals can use different two-factor authentication settings. If one portal uses 2FA and another does not, users need to enter 2FA codes in at least 1 direction, when they switch portals.
Two-factor authentication doesn't affect user passwords.
See: Portal setup: two-factor authentication (2FA).
See: