# Embedding the Widget

The embed widget offers a seamless way to integrate your portal into your application or website. With a simple click on a trigger in form of a link or button, users can access a dialog box displaying the most recent announcements. Additionally, the trigger conveniently displays a badge indicating the presence of new announcements.

{% hint style="warning" %}
To enable users to log in, you must add the domain's URL to the list of [trusted domains](https://docs.released.so/guide/product/administration/trusted-domains). The URL must include the subdomain. For example `feedback.example.com`.
{% endhint %}

## Installation instructions

{% stepper %}
{% step %}

### Copy the channel ID

[Copy the channel ID](https://docs.released.so/guide/resources/how-tos/finding-the-channel-id) for the embed widget.
{% endstep %}

{% step %}

### **Select which modules to include**

Choose whether to embed the Changelog, the Roadmap, or both by selecting which modules to include in the embed.

<figure><img src="https://1499735372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCU5VgN3YVTfigwSnbdbk%2Fuploads%2FE05ucWion8IauZpdjr2K%2FSettings%20-%20Install%20instructions.png?alt=media&#x26;token=1d81a4bf-33f7-4288-8d38-7b86835181a0" alt=""><figcaption><p>Select which modules to include</p></figcaption></figure>
{% endstep %}

{% step %}

### **Add the embed script**

Add the following code snippet to the `<head>` section of your site.

```markup
<script src="https://embed.released.so/1/embed.js" defer></script>
```

{% endstep %}

{% step %}

### **Add the released-widget element to your page**

Add the following code snippet to the `<body>` section of your site. The widget will not be rendered inline, so it does not matter where in the body you position the element. Ensure you replace the `CHANNEL_ID` attribute.

```markup
<released-widget channel-id="CHANNEL_ID"></released-widget>
```

To automatically authenticate users, you can [implement user verification](https://docs.released.so/guide/getting-started/setup-guide/implementing-user-verification) and pass in the `auth-token` attribute.

```
<released-page channel-id="CHANNEL_ID" auth-token="AUTH_TOKEN"></released-page>
```

{% endstep %}
{% endstepper %}

## Optional step

{% stepper %}
{% step %}

### **Customize the widget (optional)**

Customize the widget to match your brand and app design using the widget properties. Adjust the title and description, or change the colors according to your preferences.

Please see the documentation for a full list of [configuration options](https://docs.released.so/guide/product/portals/portal/widget).
{% endstep %}
{% endstepper %}

## Example

View an example of how to embed the widget on [CodePen](https://codepen.io/released/pen/WNaaMNx).
