> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Copilot: HTML Tile

<a href="/release-notes/4.90"><Badge className="version-badge" color="blue">Updated in 4.90</Badge></a>

<Frame>
  <img class="image-center" src="https://mintcdn.com/cognigy-15abf2ba/zkuN4mfSk9TWL7kq/_assets/ai/develop/node-reference/agent-copilot/set-html-tile.png?fit=max&auto=format&n=zkuN4mfSk9TWL7kq&q=85&s=78509dbd89de11c7cc14b0a74bf63fad" alt="Copilot HTML Tile Node configuration panel" style={{ width: 'auto' }} width="466" height="126" data-path="_assets/ai/develop/node-reference/agent-copilot/set-html-tile.png" />
</Frame>

## Description

This Node displays HTML content in the Agent Copilot workspace. You can design custom layouts to present information to a human agent. HTML content may include text, images, videos, links, and scripts. The Set HTML Tile Node is useful for displaying complex information.

Technically, the HTML content will be injected into an [iFrame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) on the workspace side, so any general restrictions on iFrames also apply to this case.

## Parameters

| Parameter    | Type          | Description                                                 |
| ------------ | ------------- | ----------------------------------------------------------- |
| Tile ID      | CognigyScript | The ID that you created in the Agent Copilot configuration. |
| HTML Content | HTML          | The HTML content to render inside the Widget.               |
| JSON Data    | JSON          | The data to send to the iframe as a postMessage event.      |

## Using React or Angular

In the Copilot: HTML Tile Node, you can enhance your HTML content by utilizing the [React](https://react.dev/) or [Angular](https://angular.dev/) libraries.
These libraries allow you to seamlessly display dynamic widgets within your workspace.
To use these libraries in the Copilot: HTML Tile Node, you need to include them in your HTML code.

<Accordion title="Example">
  ```html theme={null}
  <!DOCTYPE html>
  <html lang="en">
    <head>
      <meta charset="UTF-8" />
      <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
      <title>Minimal React Widget</title>
      <!-- External React libraries -->
      <script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
      <script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
      <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
    </head>
    <body>
      <div id="root"></div>

      <script type="text/babel">
        const { useState } = React;

        // this event listener processes incoming data updates
        window.addEventListener("message", function (event) {
          console.log("Content of message: " + event.data);
        });

        function ReactWidget() {
          const [name, setName] = useState('');
          const [message, setMessage] = useState('');

          const handleData = () => {
            if (name) {
              setMessage('Your name is ' + name);
            } else {
              setMessage('Please enter your name.');
            }
          };

          return (
            <div>
              <input
                type="text"
                value={name}
                onChange={(e) => setName(e.target.value)}
                placeholder="Name"
              />
              <button onClick={handleData}>Submit</button>
              <p>{message}</p>
            </div>
          );
        }

        ReactDOM.render(<ReactWidget />, document.getElementById('root'));
      </script>
    </body>
  </html>
  ```
</Accordion>

## Receiving JSON Data from the Flow

When you use a Copilot: HTML Tile, JSON data is passed into the HTML code using the [postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) method.
To receive and process the passed JSON in your widget, add an event listener into the Copilot: HTML Tile Node and handle the data accordingly.

```js theme={null}
window.addEventListener("message", function (event) {
  console.log("Content of message: " + event.data);
});
```

## Sending JSON Data back to the Flow

You can send data back to the Flow by using the Postback feature.

<Accordion title="Postback">
  The Postback feature allows you
  to send data either back to the Flow or chat, or directly to the widget interface.
  This feature can be useful for updating the state of your widget based on human agent interactions.
  These interactions can include actions such as submitting forms,
  updating display elements, or notifying the system of changes made by the human agent.

  The Postback feature can be configured in the following ways:

  * [Using SDK.postback](#using-sdkpostback)
  * [Using the Copilot: Send Data](#using-the-copilot-send-data)

  ### Using SDK.postback

  Follow these steps to implement postback for your widget:

  1. Add the `SDK.postback` function to the HTML page. Make sure this code is included after the SDK script is loaded:

  <Tabs>
    <Tab title="Send a String">
      ```html theme={null}
      <button type="button" onclick="SDK.postback('value');">Yes</button>
      ```
    </Tab>

    <Tab title="Send an Object">
      ```js theme={null}
      <button type="button" onclick="SDK.postback({ "key": "value" });">Yes</button>
      ```
    </Tab>
  </Tabs>

  2. Click the button in the widget in the Agent Copilot workspace. Triggering this action will send an injected message formatted as follows:
     ```json theme={null}
     {
     "data": {
         "_cognigy": {
         "_agentAssist": {
             "type": "submit",
             "payload": "value"
         }
         }
     }
     }
     ```

  To allow human agents to view this object, add `{{ input.data._cognigy._agentAssist }}` to the **Text** field in the Say Node of your Agent Copilot Flow.
  This Node should be placed below the Node with the `SDK.postback` function.
  The output will be available in the chat message and visible only to human agents.

  #### Example

  In this example, the `SDK.postback` function sends the value of `name` back to the user.
  If `name` is falsy, meaning the user did not enter a name, the `else` block is executed, and the function calls `setMessage('Please enter your name.');`.
  This message will appear in the widget, prompting the user to provide their name and reminding them of the required input.

  ```html theme={null}
  <!DOCTYPE html>
  <html lang="en">
  <head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
  <title>Minimal React Widget</title>
  <!-- External React libraries -->
  <script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
  <script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
  <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
  </head>
  <body>
  <div id="root"></div>
  <script type="text/babel">
          const { useState } = React;

          // This event listener processes incoming data updates
          window.addEventListener("message", function (event) {
              console.log("Content of message: " + event.data);
          });

          function ReactWidget() {
              const [name, setName] = useState('');
              const [message, setMessage] = useState('');

              const handleData = () => {
                  if (name) {
                      setMessage('Your name is ' + name);
                      SDK.postback(name);
                  } else {
                      setMessage('Please enter your name.');
                  }
              };

              return (
                  <div>
                      <input
                          type="text"
                          value={name}
                          onChange={(e) => setName(e.target.value)}
                          placeholder="Name"
                      />
                      <button onClick={handleData}>Submit</button>
                      <p>{message}</p>
                  </div>
              );
          }

          ReactDOM.render(<ReactWidget />, document.getElementById('root'));
      </script>
  <button type="button" onclick="SDK.postback('yes');">yes</button>
  </body>
  </html>
  ```

  ### Using the Copilot: Send Data

  In the Agent Copilot Flow, below the Copilot: HTML Tile Node, add a [Copilot: Send Data](/ai/agents/develop/node-reference/agent-copilot/send-data).
  In the **JSON** field of the Copilot: Send Data Node,
  specify the parameters you want to pass as metadata to the Copilot: HTML Tile Node to update the content.
</Accordion>

## More Information

* [Copilot: Adaptive Card Tile](/ai/agents/develop/node-reference/agent-copilot/set-adaptive-card-tile)
* [Copilot: IFrame Tile](/ai/agents/develop/node-reference/agent-copilot/set-iframe-tile)
* [Copilot: Send Data](/ai/agents/develop/node-reference/agent-copilot/send-data)
* [Copilot: Set Grid](/ai/agents/develop/node-reference/agent-copilot/set-grid)
* [Agent Copilot Nodes](/ai/agents/develop/node-reference/agent-copilot/overview)
* [Agent Copilot](/agent-copilot/overview)
