---
title: Set-up
slug: technical-docs/set-up
docTags: 
createdAt: 2026-01-09T14:07:11.984Z
---

# Installation

To get started with IntelliProve widgets, include the IntelliProve widget bundle in your application. This script must be loaded **once**, in the `<head>` of your document.

The bundle registers all IntelliProve web components globally, making them available as custom HTML elements throughout your application.

```javascript
<script 
	type="module" 
	src="https://cdn.intelliprove.com/packages/intelli-widgets/v3/latest.js">
</script>
```

# Create your session

All IntelliProve web components must be wrapped inside an `<ip-session>` element.

The session component acts as a **global configuration and context provider**, making shared settings — such as authentication and language— available to all nested IntelliProve components.

**Key rules & information**

- All IntelliProve web components must exist within the descendant tree of `<ip-session>`. They are not required to be direct children and can be nested at any level.
- Standard HTML elements that are not part of IntelliProve may also be placed within `<ip-session>`

| **Session properties** | **Requirement**                               | **Description**                                                                                           |
| ---------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `action-token`         | <font color="#B91C1C">**required**</font>**** | Action token of the user's current session. Request one via the [Rest API](docId\:BiuPVixvHltbukKLR2ATI). |
| `language`             | <font color="#6b7280">*optional*</font>       | Language with or without region, e.g. (`en`, `en-GB`). Defaults to the browser language.                  |

**Code example**

```html
<ip-session 
	action-token="eyJhbG..."
	language="en-GB" 
>
  <!-- IntelliProve components go here -->
</ip-session>
```

**Library**

:::hint{type="success"}
[Access our widget library to integrate your first widget →  ](docId\:e52TSv_T_kBhLw0UVBTg4)&#x20;
:::