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

# Get Elements Positions

> Retrieve positions and bounding rectangles of DOM elements identified by a CSS selector

The Get Elements Positions command (Command Type: 22) retrieves the positions and bounding rectangles of DOM elements identified by a CSS selector.

## Command Type

**Command Type ID:** 22

## Parameters

| Parameter    | Type    | Description                                  | Required |
| ------------ | ------- | -------------------------------------------- | -------- |
| **selector** | string  | CSS selector for the target elements         | Yes      |
| **timeout**  | number  | Timeout in milliseconds                      | Yes      |
| **filters**  | Filters | Optional filters to refine element selection | No       |

### Filters Object

| Field                | Type            | Description                                              |
| -------------------- | --------------- | -------------------------------------------------------- |
| **className**        | string          | Filter by class name                                     |
| **includeInnerText** | Array of string | Include elements whose inner text contains these strings |
| **excludeInnerText** | Array of string | Exclude elements whose inner text contains these strings |

## Usage Examples

### Get Button Positions

```json theme={null}
{
  "command": "get-elements-positions",
  "params": {
    "selector": "button.action",
    "timeout": 10000
  }
}
```

### Get Filtered Element Positions

```json theme={null}
{
  "command": "get-elements-positions",
  "params": {
    "selector": ".list-item",
    "timeout": 10000,
    "filters": { "includeInnerText": ["Live"] }
  }
}
```

## Related Commands

* [Get Full Elements Positions](/stream/commands/browser/get-full-elements-positions) - Includes viewport/document resolution info
* [Get Page Rectangle](/stream/commands/browser/get-page-rectangle) - Get the overall page dimensions