openpencil/packages/docs/programmable/sdk/api/composables/use-export.md

---
title: useExport
description: Manage export settings like scale and format for the current selection.
---

# useExport

`useExport()` is the export-panel composable for selected nodes.

It manages:

- export settings rows
- selected node ids
- export name labeling
- supported scales and formats (`formats` ids and labeled `formatOptions`)

## Usage

```ts
import { useExport } from '@open-pencil/vue'

const exportState = useExport()
```

## Basic example

```ts
const {
  settings,
  nodeName,
  scales,
  formats,
  formatOptions,
  addSetting,
  updateScale,
  updateFormat,
} = useExport()
```

## Practical examples

### Add another export preset

```ts
exportState.addSetting()
```

### Change the first export to 2x WEBP

```ts
exportState.updateScale(0, 2)
exportState.updateFormat(0, 'webp')
```

## Related APIs

- [useSelectionState](./use-selection-state)
- [useEditor](./use-editor)