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

# Dimension

Find products that fit within a size or weight range.

This is useful for carry-on luggage limits, furniture that fits a space, or shipping weight restrictions.

> [!NOTE]
>
> Dimension filters apply at the **offer** level. A product passes if **any**
> of its offers falls within the ranges you set.

## Basic dimension filter

Set `min`, `max`, or both on `length`, `width`, `height`, and `weight`. Each field needs a `unit`. Pass only the fields you care about.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import Channel3 from "@channel3/sdk";

const client = new Channel3();

const results = await client.products.search({
  query: "carry-on suitcase",
  filters: {
    dimensions: {
      height: { max: 22, unit: "in" },
      width: { max: 14, unit: "in" },
      weight: { max: 8, unit: "lb" },
    },
  },
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from channel3_sdk import Channel3

client = Channel3()

results = client.products.search(
    query="carry-on suitcase",
    filters={
        "dimensions": {
            "height": {"max": 22, "unit": "in"},
            "width":  {"max": 14, "unit": "in"},
            "weight": {"max": 8,  "unit": "lb"},
        },
    },
)
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://api.trychannel3.com/v1/search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "carry-on suitcase",
    "filters": {
      "dimensions": {
        "height": { "max": 22, "unit": "in" },
        "width":  { "max": 14, "unit": "in" },
        "weight": { "max": 8,  "unit": "lb" }
      }
    }
  }'
```

## Units

Length units: `mm`, `cm`, `m`, `in`, `ft`. Weight units: `mg`, `g`, `kg`, `oz`, `lb`.

You can mix units in one request — filter height in inches and weight in pounds, for example.

## Filter one dimension

Set only the fields you need. Here, find suitcases under 8 pounds:

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "carry-on suitcase",
  filters: {
    dimensions: {
      weight: { max: 8, unit: "lb" },
    },
  },
});
```

> **[Search](/guides/search.md)**
>
> Full overview of the search endpoint and all available filters.

> **[Localization](/guides/localization.md)**
>
> Set default units, country, language, and currency on the client.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.