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

Frame communication does not work when URLEncryption is enabled



On enabling URLEncryption, the frame communication does not work correctly. This affects the Web Mashup resizing and user clicks within the content.

For example:

A link on the initial mashup page should open the work object within the mashup space. However, when URLEncryption is enabled, the work object displays in a popup window. With URLEncryption disabled, the work object displays correctly within the Mashup.

Error Messages

Not Applicable

Steps to Reproduce

Enable simple Mashup with URLEncryption.

Root Cause

To enable URLEncyrption, the Mashup must use an HTTP POST on the initial gadget load. This is accomplished with the following JavaScript:


When using this, the UI does not set isWebMashup to true on the pxThread page. Hence, the window.postMessage methods at the UI level do not run correctly.


Perform the following local-change:

1. Include the below Script Block: <script>

2. Set the Mashup Div element parameters attribute as below:

Add isWebMashup:'true' to data-pega-action-param-parameters Mashup div attribute.

For example:


3. Set the Pega Platform Server settings as below:

prconfig/initialization/urlencryption/default = true
prconfig/initialization/submitobfuscatedurl/default = optional


Published November 29, 2018 - 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