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

# Modules

> Modules help you organize related features into logical groups—similar to epics in Agile or categories in a large project. This makes project management clearer and easier, especially for teams with many features.

## 1. What is a Module?

* A **module** is a way to group related features together.
* Each module can represent a business flow, an epic, or a category.
* **Example:**
  * The `Authentication` module contains features like login, signup, and forgot password.
  * The `Lead` module contains features for lead management.

## 2. Viewing and Managing Modules

**To access module management:**

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/filter_module01.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=696522e43f6d8b2782c4f1d4c078f79e" alt="Filter Module01 Pn" title="Filter Module01 Pn" style={{ width:"37%" }} width="672" height="788" data-path="images/filter_module01.png" />

1. In your project’s sidebar, click the **three dots** icon next to the feature search bar.
2. Select **Manage modules** from the dropdown.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/project_modules.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=7b548c500f00ad8a3793255eb44d9609" alt="Project Modules Pn" width="2234" height="2136" data-path="images/project_modules.png" />

You will see the list of all modules in your project. You can view the features belong the modules.

## 3. Adding a New Module

1. In the project screen, go to the **Modules** tab.
2. Click the **+ Add Module** button.
3. The **Add New Module** dialog will appear:

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/add_new_module.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=bb7bce3aa83e87b96637f31f671d2a38" alt="Add New Module Pn" title="Add New Module Pn" style={{ width:"69%" }} width="1382" height="1700" data-path="images/add_new_module.png" />

* **Module Name** (required):\
  Enter a descriptive name for the module (for example: `Authentication`).
* **Description** (optional):\
  Optionally describe the module’s purpose and scope.
* **Add Features to Module (Optional):**\
  Use the search box to find features and select the ones you want to include in this module.\
  You can leave this empty and add features later.

4. Click **Save Module** to create the module.

## 4. Adding Features to a Module

You can add features to a module from two locations:

### 4.1. From the Features Tab in Project Details

1. Go to the **Features** tab of your project.
2. Click the **three dots** next to the feature you want to add.
3. Select **Add to Module**.
4. A popup will appear. Select one or more modules and click **Add to x module(s)**.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/Add-to-module-1.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=a1d99c324a733bc39311327f2aaaf70d" alt="Add To Module 1 Pn" title="Add To Module 1 Pn" style={{ width:"88%" }} width="1576" height="598" data-path="images/Add-to-module-1.png" />

### 4.2. From the Sidebar

1. In the sidebar, click the **three dots** next to the feature.
2. Select **Add to Module**.
3. A popup will appear. Select one or more modules and click **Add to x module(s)**.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/add-to-module-2.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=fb854812b34ddb9c412a3883a980d1c2" alt="Add To Module 2 Pn" title="Add To Module 2 Pn" style={{ width:"71%" }} width="1104" height="708" data-path="images/add-to-module-2.png" />

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/Add-to-module-3.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=0bf275bc6827d00cbb15aca35f85e2c3" alt="Add To Module 3 Pn" title="Add To Module 3 Pn" style={{ width:"73%" }} width="1390" height="942" data-path="images/Add-to-module-3.png" />

## 5. Removing a Feature from Module

1. In the project screen, go to the **Modules** tab.
2. Click the **three dots** on the feature you want to remove.
3. Select **Remove from Module** from the dropdown menu.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/remove-from-module.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=b28125dc47d59b6a19d92e171941d7d8" alt="Remove From Module Pn" title="Remove From Module Pn" style={{ width:"80%" }} width="1344" height="456" data-path="images/remove-from-module.png" />

The feature will be removed from the selected module, but will remain available in your project and can still belong to other modules.

## 6. Editing a Module

1. In the modules list, click the **three dots** next to the module you want to edit.
2. Select **Rename module** (or **Edit module**).
3. The **Edit Module** dialog will appear:

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/rename-module.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=e25b2ad7412e99109f9f1394a5ec2f1f" alt="Rename Module Pn" width="1488" height="460" data-path="images/rename-module.png" />

* Edit the module name and/or description as needed.
* Click **Update Module** to save your changes.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/edit-module.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=9b56438ea6472ca74087aae27eeecdb6" alt="Edit Module Pn" title="Edit Module Pn" style={{ width:"80%" }} width="1400" height="758" data-path="images/edit-module.png" />

## 6. Deleting a Module

1. In the modules list, click the **three dots** next to the module you want to delete.
2. Select **Delete module**.
3. A confirmation dialog will appear:

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/delete-module.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=2cc230e21abad18576523a775aa770ac" alt="Delete Module Pn" title="Delete Module Pn" style={{ width:"60%" }} width="1098" height="446" data-path="images/delete-module.png" />

* Click **Confirm** to permanently delete the module.
* Click **Cancel** to abort.

> **Note:** Deleting a module does **not** delete the features inside it. The features will remain in your project.

<Note>
  **Tips:**

  * A feature can belong to multiple modules.
  * Use modules to organize your project by business flows, epics, or main categories.
  * You can edit, add, or delete modules at any time.
</Note>

## 7. Filtering Features by Module

You can easily filter the feature list in your project by module, allowing you to focus on just the features relevant to specific business flows, epics, or categories.

### 7.1. How to Filter by Module

1. In your project sidebar, click the **three dots** icon next to the feature search bar.
2. Under **Filter by modules**, you’ll see a list of all modules in the project.

<img src="https://mintcdn.com/xbirds/_S7bMQeCJpK9fDhq/images/filter-by-modules.png?fit=max&auto=format&n=_S7bMQeCJpK9fDhq&q=85&s=9171489219b5d18fc7a39c71e212d957" alt="Filter By Modules Pn" title="Filter By Modules Pn" style={{ width:"64%" }} width="824" height="628" data-path="images/filter-by-modules.png" />

### 7.2. Filtering Behavior

* **No modules selected:**\
  All features in the project are displayed.
* **One module selected:**\
  Only features that belong to the selected module are shown.
* **Multiple modules selected:**\
  All features that belong to any of the selected modules are shown together.

You can check or uncheck modules at any time to refine your view.\
This makes it easy to focus on specific areas of your project, such as only seeing features for “Authentication” or for both “Authentication” and “Lead” at once.
