Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Cannot embed a mashup in a Pega application

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Ensure that your mashups loads successfully when you embed a mashup in a Pega application.


The mashup does not load when you try embedding it in a Pega application.


When you try to embed a Pega web mashup inside a Pega application instead of a web page, the mashup needs to comply with the pzIncludeMashupScripts activity of the host site, without a mismatch in the code stack between different Pega Platform versions.


  • Do not include the pzIncludeMashupScripts script tag in any section of the application, because this script tag overwrites the existing Pega JavaScript object. Include the following custom mashup scripts to ensure that mashup loading, resizing, and registration behaves as expected for the host web site:
    <pega:onlyonce name="MashupScriptsCustom">
    <pega:static type="script" app="webwb">
    <pega:file name="PegaCompositeGadgetMgr.js"/>
    <pega:file name="pzpega_postmessage.js"/>
    <pega:file name="pzpega_web_mashup.js"/>
    <pega:file name="pzpega_web_mashup_hostActionsProcessor.js"/>
  • Previous topic Cannot load a mashup from a non-default access group
  • Next topic Troubleshooting browser-specific issues with mashups

Have a question? Get answers now.

Visit the Support 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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us