# The Matrix

**Example URL:** <https://pentest.ws/e/{engagement.id}/matrix>

The **Matrix** provides a high-level, interactive view of your entire engagement — showing every host and port in one place. It’s designed to help you spot patterns, identify targets, and quickly pivot into deeper testing.

![](/files/3CL4SQCLkdL7JrAHu7JJ)

#### Key Features

* **Complete Engagement View** – See all hosts and ports at a glance.
* **Flexible Filtering** – Narrow results by operating system, host type, host flags (including color flags), or port number/state/status.
* **Board Integration** – Filters and organization work seamlessly with your existing Boards.

#### How It Works

* Use filters at the top of the Matrix to refine your view.
* The sidebar automatically syncs with your selection, letting you jump into any host instantly.
* Port states and host attributes update dynamically, helping you track progress in real time.

#### Collaboration in Pro Tier

In shared engagements, the Matrix becomes a **personalized view** for each teammate. Every tester can apply their own filters and focus on their own objectives without disrupting the workflow of others.

#### Why Use the Matrix?

* Spot live services across dozens of hosts in seconds
* Prioritize targets for deeper testing
* Maintain situational awareness across large environments

## Tier Availability

**The Matrix** is available on all tiers.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentest.ws/views-and-filtering/the-matrix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
