> For the complete documentation index, see [llms.txt](https://docs.intuneassistant.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intuneassistant.cloud/intune-assistant/modules.md).

# Modules

## What it does

**Modules** is the one place where you see what your tenant has and how far its setup is. A **module** is a service you have activated, such as Security Insights. An **extension** is a building block that modules use, such as the Worker. Every module and extension has the same page: what it is, the version, a link to its documentation and changelog, and a list of setup steps with where each one stands.

A module shows up here as soon as your tenant has it. You start its setup from here.

## How to use it

1. Open your name at the bottom of the menu, choose **Customer Settings** and then the **Modules** tab (next to **Customer**). An orange number on your name, on **Customer Settings** and on the tab tells you how many modules have a step that waits for you, the same way an unread message does.
2. On the tab, Modules and extensions are listed separately. Each card shows the name, its version and how many setup steps are done. A module that needs the Worker also shows the Worker's state on its own card.
3. The label on the card tells you what is next: **Ready** (nothing to do), **Action needed** (a step waits for you) or **In progress** (a step is running and takes time, for example a new permission that is not active yet).
4. Open a card. The steps are listed in the order to work through them. A step says **Done**, **Needs you**, **Working on it** or **Not reached yet**, with one sentence of explanation.
5. A step that is not done has a button that tells you how, for example how to deploy a Worker or how to add the Worker's permissions. Under the steps, the guide for that module helps with the rest, for example approving permissions in your tenant or granting roles to your Worker.
6. The page checks again by itself, when you come back to the tab and once a minute while a step is open. **Check again** does it right away.

## When a module is activated for you

You do not have to look for it. A message appears in your Message Center (the number on your name in the menu) saying which module is now active, and the Modules tab shows a **New** label, a note at the top of the page and a **New** badge on the card until you have opened it or chosen **Got it**. The app asks for what your organisation has every 15 minutes, so a module that is activated while you are working shows up within that time; reloading the page shows it at once. If several modules are activated together you get one message that lists them. What you have to do next, per module, is on the page [After a module is activated](https://docs.intuneassistant.cloud/intune-assistant/modules/getting-started.md).

## What you will see

On a module's page you find, from top to bottom: what the module is and what is waiting for you, the setup steps, the guide for the open step, the permissions involved (the permissions an administrator approves for your tenant, marked *Read only* or *Can change*, and the roles the Worker's identity needs), and how to remove the module again.

* **Configuration Management** is one card for the whole area, Assignments Manager included. Its steps: it is active, the permissions it needs in your tenant are approved (an administrator does this once, from the card), and the permission check confirms them. If you only have Assignments Manager, the card is still the place to finish its setup.
* **Security Insights** has these steps: it is active, your Worker has the package, the Worker has the roles this module adds, the tenant permissions are approved, and the first check can run.
* **Worker** is an extension with its own steps: a Worker is deployed, and it holds its base roles. The base roles belong to the Worker and are set up once, whichever modules use it. The roles a module adds on top are shown on that module's page.
* A module that needs the Worker lists it as a step, and links to the Worker page when the Worker itself still needs something.

## Requirements

You see a module here when your tenant has an active entitlement for it. If you manage tenants for customers (MSP), switch to the customer tenant first: the page always shows the tenant you are working in, not your own.

## Common questions

**A module I expect is not listed.** The tenant you are working in does not have it. Check the tenant name at the top of the page.

**It says the Worker needs its base permissions, but I opened Security Insights.** The base roles belong to the Worker, so they are fixed on the Worker, using [Add worker permissions](https://docs.intuneassistant.cloud/extensions/worker/add-worker-permissions.md). The module page links there.

**A new permission takes long to show.** A Worker keeps the access token it has for up to 24 hours, and a restart does not renew it. The step says *Working on it* until the Worker uses the new token.

**How do I remove a module?** The module page explains it step by step. Ending the subscription is done by your platform administrator (or your MSP for a tenant they manage); nothing is removed from the page itself. Withdrawing the approved permissions and the Worker roles is done in Microsoft Entra ID, and the page lists exactly which ones.

**It says my Worker is not approved yet.** A Worker registers itself the first time it starts and then waits for approval. Approve it on the Workers page. The step names the Worker and when it registered, so you can tell it apart from a Worker that was never deployed.
