Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Pega 7 migration issue - Compatibility view not supported



Users application has been upgraded from PRPC 5.5 SP1 to Pega 7.1.6. Developer Portal is not loading. It is saying Compatibility view not supported.

Error Messages

Compatibility view not supported.

Steps to Reproduce

1. Access the Developer URL.
2. Enter the user name and password.

Root Cause

The root cause of the reported behavior is user application which is rendering in compatibility mode.


Here’s the explanation for the reported behavior: 

The user earlier was using PRPC 5.5 version so user has enabled compatibility view outside of PRPC to support their 5.5 app. This can be done through various means such as locally on the browser, pushed out through group policy, and so on.In other words, they have environmentally added this setting, independent of Pega.

Now that user is on Pega 7, is hosted on the same domain, hence Pega 7 app is breaking, as it is intended to run in HTML 5 standards.

User has already added this local-change “<meta http-equiv="X-UA-Compatible" content="IE=edge">” in pyMetaTags to support the compatibility for the application.

Note: Pega will not be supporting designer studio while running in compatibility view. Pega has and will continue to be very strict regarding developers and the browser requirements. But it is more flexible when discussing end user portals for business users.

Recommended approach is to set each and every harness to be rendered in HTML5 standards mode. You can make use of HTML5 Application Readiness<>

The below two links will help you know more about the HTML5 document type option necessity in application after upgrading. Read through the below links:


Make sure that Pega 7 renders in standards mode which would resolve the reported behavior.

Read through the below article which might be of help:


Published May 13, 2016 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us