Enable Unified Interface Only
Applies to Dynamics 365 for Customer Engagement apps version 9.x
In 2018, we introduced Unified Interface, the latest generation of web app design for the PowerApps model-driven apps and Dynamics 365 for Customer Engagement apps. It brings the best in usability, accessibility, functionality, and speed to every user. Improve how your business applications run by using only the Unified Interface. To learn how to enable it, see How to enable Unified Interface Only. For more information, see What experiences are available in Unified Interface Only and FAQs.
When does the Unified Interface Only experience become available, and which environments are affected?
All new Dynamics 365 for Customer Engagement environments (instances) and Common Data Service environments, including those created in existing tenants, will be provisioned in Unified Interface Only mode per the schedule below.
Note: Some geographical regions will get the changes ahead of schedule by as much as 2-3 weeks.
|Environment (instance) types||Release date|
|New Trial Dynamics 365 for Customer Engagement instances||December 12, 2018|
|New Trial and Production Common Data Service environments||February 2, 2019|
|New Production and Sandbox Dynamics 365 for Customer Engagement instances||June 8, 2019|
Environments created before the scheduled release dates will not get this change automatically. Version 126.96.36.19948 onwards, administrators will have the option to change the environment settings to get the Unified Interface Only experience. It is recommended to switch to this mode by following the steps at How to enable Unified Interface Only.
For existing environments, it’s recommended that you:
- Read What experiences are available in Unified Interface Only and understand how it affects end users in your environment.
- Test the changes in your Trial or Sandbox environments before applying to your production environment.
What experiences are available in Unified Interface Only mode
New immersive home page experience on web
Unified Interface Only mode provides easier and quicker access to apps, and gives users the ease of working in simple purpose-built apps. Users with just one app available to their security roles land directly in the app after signing in using the environment URL (for example: https://contoso.crm.dynamics.com/). The first page they see is determined by the first page of the app.
Users with multiple apps see the list of apps available to them, and can navigate to them by selecting the app tile.
This change applies to environment URL based sign-in (for example, https://contoso.crm.dynamics.com/) on the web. It doesn’t affect users who sign in using home.dynamics.com or other portals. The sign-in and home page experience for Dynamics 365 for phones and Dynamics 365 for tablets remains unchanged. You can learn more at Signing in and signing out (for iOS users) and Signing in and signing out (for Android users).
Run all apps in Unified Interface Only mode
Unified Interface is centered around the concept of modular applications known as model-driven apps. These apps allow developers and admins to streamline the data and functionality to provide exactly what end users need.
In Unified Interface Only mode, all model-driven apps, including those created for the legacy web client, run in Unified Interface to provide superior performance and usability.
Deep linking apps and pages
With Unified Interface Only mode, all URLs (or deep links) open in Unified Interface in the context of the app being referenced. For more information on constructing links, see Open forms, views, dialogs, and reports with a URL.
If no app is referenced in the URL, the record or page opens without any navigation elements on the page. Navigation elements like sitemap are defined using an app; URLs without apps don’t have them. Users can use the app switcher to navigate to an app and continue their work.
Dynamics 365 - custom
The legacy web client app, also known as Dynamics 365 - custom, is hidden from end users when a new environment is provisioned. It is always visible to those with System Administrator and System Customizer roles, and to other custom roles with similar privileges. The legacy web client app should only be used temporarily for backwards compatibility with custom and third-party legacy functionality that you have not migrated to Unified Interface. It is not designed for Unified Interface and can cause unexpected errors and experience. For the best user experience, port all custom and third-party functionality to model-driven apps for Unified Interface.
When Unified Interface Only mode is enabled, Dynamics 365 - custom opens in Unified Interface and not in the legacy web client. If users only have access to the Dynamics 365 – custom app and no other model-driven apps, they won’t be redirected automatically when signing in using the environment URL (for example, https://contoso.crm.dynamics.com/). Access to this app can be enabled in one of two ways:
- In Dynamics 365 for Customer Engagement, go to Settings > Administration > System Settings > General tab. Under Show legacy Dynamics 365 - custom app, select Yes for Show this app to all users, not just administrators.
- In the Power Platform Admin center, go to Environments and select an environment. Go to Settings > Behavior > Interface settings and then turn on Show legacy app to everyone, not just admins.
When Unified Interface Only mode is enabled, environment settings can be accessed via a menu on the navigation bar. Follow these steps to navigate to Advanced Settings:
Select Settings () on the navigation bar.
Select Advanced Settings.
You need to select Advanced Settings from a Customer Engagement app page that's displayed in the Unified Interface such as Sales Hub or Customer Service Hub pages.
How to enable Unified Interface Only mode
Unified Interface Only can be turned on and off in one of two ways:
- In Dynamics 365 for Customer Engagement, go to Settings > Administration > System Settings > General tab. Under Use the new Unified Interface only (recommended), select Yes for Enable only the Unified Interface.
- In the Power Platform Admin center, go to Environments and select an environment. Go to Settings > Behavior > Interface settings and then turn on Use Unified Interface only.
Is there any downtime while applying this change?
No, this change applies immediately, upon reloading the page. If it doesn't, clear cache and retry.
Business users in my environment are still using the legacy web client for all or some of the scenarios, and our business is not completely ready to move to Unified Interface. How does the Unified Interface Only setting impact my environment after the April 2019 release?
This setting is preset to Off for your environment, and you are unaffected by the April 2019 release. It is recommended that you take advantage of the benefits of Unified Interface early by turning Unified Interface Only mode on.
I want to use Unified Interface for all the apps, but still want Dynamics 365 – custom to open in the legacy web client. Is that possible?
You can achieve this by setting all apps to be Unified Interface apps. Note that this won't change the home page experience to Unified Interface. Unified Interface Only mode is a prerequisite to get the new home page experience.
How do I resolve errors seen while using a Dynamics 365 - custom legacy app in Unified Interface?
If there are issues with Unified Interface, please let us know.
How does it impact my Unified Service Desk deployment?
To learn about the impact of Unified Service Desk, see Impact of Unified Interface Only availability with Unified Service Desk.