> ## 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.
</Note>

## 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.

<CodeGroup>
  ```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" }
        }
      }
    }'
  ```
</CodeGroup>

## 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" },
    },
  },
});
```

<Cards>
  <Card title="Search" icon="magnifying-glass" href="/guides/search" arrow="true">
    Full overview of the search endpoint and all available filters.
  </Card>

  <Card title="Localization" icon="globe" href="/guides/localization" arrow="true">
    Set default units, country, language, and currency on the client.
  </Card>
</Cards>