Skip to main content

Communicate with Embedded Appsmith

Enterprise

Cross-origin communication between an embedded Appsmith app and your app can be achieved through sending messages. This page shows how to send messages between the embedded Appsmith app and your parent app.

Prerequisites​

  • Embed the Appsmith app in your parent app. For more information, see Embed Appsmith.

Send messages to parent app​

To send messages from the embedded Appsmith app to the parent app, follow these steps:

Send message from Embedded Appsmith to Parent app
Send message from Embedded Appsmith to Parent app

  • To send a message from embedded Appsmith to the parent app, use the global function postWindowMessage() in your JS Object or configure a post message action for your widget in the Properties pane. For example, to send a message at the click of a button widget, select the Post message action for the onClick event, add the message details in the Message field, and set the Target as window. Alternatively, use the postWindowMessage() by enabling the JS as shown below:

    //replace the "Message content" with your actual message.
    //Set the Target as window, and replace 
    //the "<Parent_app_hosted_url>" with the Parent app domain
    postWindowMessage("Message content", 'window', "<Parent_app_hosted_url>");

  • To receive the messages in the parent app, use the addEventListener() method of the window object that adds an event listener in your parent app.

    //add this code in your app that you've embedded in Appsmith using the Iframe widget
    const messageHandler = (event) => {
        //The message sent is available in the event object.
        if(event) {
        // Read the message by using the event.data property
        const messageReceived = event.data;
        console.log(messageReceived);
        //Add code to manipulate the received message
        }
    };

    //add the event listener to read the incoming message
    window.addEventListener('message', messageHandler);

      // Remember to unlisten to the event when it's no longer needed
      // For example, unlisten when you have successfully processed the message
      // window.removeEventListener('message', messageHandler);

    Read the received message using the event.data property. Add or update the code in the addEventListener() method to process the received message. Moreover, it's crucial to unlisten to the messages when they are no longer needed by invoking the removeEventListener() method.

Send messages to Appsmith​

To send messages to the embedded Appsmith app from the parent app, follow these steps:

Send message from Parent app to embedded Appsmith
Send message from Parent app to embedded Appsmith

  • To send messages to embedded Appsmith, use the postMessage() method of the contentWindow object. Add the below code snippet in your app to send a message:

    //add this code to your embedded app.
    //message is the content of the message that you want to send to Appsmith
    function sendMessage(message) {
        if(message) {
          //Replace "<#Id_of_Iframe>" with the specific ID of the iframe 
          //containing the embedded Appsmith.
          const iFrame = document.getElementById("<#Id_of_Iframe>");
            //Send the message in postMessage
            //replace the "<Appsmith_hosted_url>" with your Appsmith domain
            iFrame.contentWindow.postMessage(message, "<Appsmith_hosted_url>");
        }
    }

    Call the sendMessage() function whenever you want to send a message. Alternatively, you can directly use iFrame.contentWindow.postMessage(message, "<Appsmith_hosted_url>") in your code.

  • For receiving the message at Appsmith, use the global function windowMessageListener() in your JS Object as shown below:

    const messageHandler = (message) => {
      if(message) {
          console.log(message);
          //Add code to manipulate the received message
      }
    };

    //replace the '<origin' placeholder with your application domain
    // from where the message had originated
    windowMessageListener('<origin>', messageHandler);

    // Remember to unlisten to the message when it's no longer needed
    // For example, unlisten when you have successfully processed the message
    // replace the '<origin' placeholder with your application domain
    // unlistenWindowMessage('<origin>');

You may choose to execute APIs, and queries or store the message in Appsmith store by adding or updating the code in the windowMessageListener() method to process the received message. Moreover, it's crucial to unlisten to the messages when they are no longer needed. Achieve this by invoking the unlistenWindowMessage() method. This ensures proper management of event listeners and helps maintain a clean and efficient communication.

See also​