---
url: 'https://adk.nht.io/api/@nhtio/adk/batteries/media/functions/toPipe.md'
---

# Function: toPipe()

```ts
function toPipe(plan: MediaPlan): string;
```

Defined in: [src/batteries/media/plan.ts:248](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/plan.ts#L248)

Render a [MediaPlan](../interfaces/MediaPlan.md) to its canonical pipe string.

## Parameters

| Parameter | Type                                      | Description         |
| --------- | ----------------------------------------- | ------------------- |
| `plan`    | [`MediaPlan`](../interfaces/MediaPlan.md) | The plan to render. |

## Returns

`string`

The canonical pipe expression.

## Remarks

Total for every plan except those containing builder-variant media refs, which throw
[E\_MEDIA\_NOT\_PIPE\_EXPRESSIBLE](../variables/E_MEDIA_NOT_PIPE_EXPRESSIBLE.md). Structured args render as quoted JSON. The output is
canonical: dot-namespaced verbs render as space-separated words, number runs compress to
ranges, strings quote per the frozen predicate.