Skip to main content

Cannot embed a mashup in a Pega application

Suggest edit
Updated on November 15, 2021

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
Did you find this content helpful? YesNo

0% found this useful

Have a question? Get answers now.

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

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