Moodle Workplace App Tenants

From MoodleDocs
This feature is part of Moodle Workplace™, which is available through Moodle Certified Partners and Service Providers only.

Mobile authentication and multi-tenancy

There are two scenarios how users log in to sites with multi-tenancy enabled:

1. The site has enabled tenants to show in the login selector:

The users will see a tenant selector window where they will be able to select the tenant they want to log in. To display a tenant in the login selector, admins will have to go to Site administration > Users > Organisation > Manage tenants and then select Show this tenant in the login selector on the tenant's Details tab.

2. The site has not enabled tenants to show in the login selector

A common login page without any tenant-specific information will be displayed. Once logged in, the user will be redirected to their tenant. The custom tenant theme will be applied at that moment.

It is also possible to automatically display a particular tenant for a user: The user will have to enter the URL to their site including the tenant id, for example: https://myworkplace.mysite/index.php?tenantid=X.

Per-tenant configuration takes place in the Mobile tab of each tenant.

Tenant Mobile

The settings on this page allow you to configure app-related settings covering app banners and mobile messaging. For each value there are three possible settings:

  • Use default: the value specified in the site-wide setting (see below) is applied to the current tenant
  • Override: the site-wide setting can be overridden with a unique value for the current tenant
  • Hidden: if a value has been locked, it won't appear on this screen and the site-wide value specified will be applied in all tenants

Each value on this screen has a site-wide counterpart elsewhere. The following values can be overridden, unless the site-wide setting has not been locked:

  • App banners (site-wide settings at General > Mobile app > Mobile appearance)
    • Enable App Banners
    • iOS app's unique identifier
    • Android app's unique identifier
    • App download page
  • Mobile messaging (site-wide settings at General > Messaging > Mobile)
    • Airnotifier URL
    • Airnotifier port
    • Mobile app name
    • Airnotifier app name
    • Airnotifier access key


Each value can be locked via the respective site-wide settings screen. Note, if a value has been locked, it will not appear in the list of values at tenant level.