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

# Import from Beamer

> Bring your Beamer posts into Onset using your Beamer API key.

The Beamer importer reads your posts through the Beamer API, so it can see drafts as well as published posts.

<Warning>
  This importer is in **beta**. Review the imported releases before pointing customers at your new page.
</Warning>

## What you'll need

Your **Beamer API key**. Find it in your Beamer account under **Settings → API**, or go straight to [app.getbeamer.com/settings#api](https://app.getbeamer.com/settings#api).

<Note>
  The key gives full access to your Beamer account, so treat it like a password. You can rotate it in Beamer once the import is done.
</Note>

## Run the import

<Steps>
  <Step title="Open Imports">
    Go to **Settings → Workspace → Import**.
  </Step>

  <Step title="Start the Beamer import">
    Find **Beamer Import** in the list and click **Start import**.
  </Step>

  <Step title="Paste your API key">
    Enter the key and submit.
  </Step>

  <Step title="Wait for the email">
    The import runs in the background. Onset emails you when it's finished, so you don't need to keep the tab open.
  </Step>
</Steps>

## What comes across

|                       |                                                                                   |
| --------------------- | --------------------------------------------------------------------------------- |
| **Title and content** | Post HTML is converted into the Onset editor format.                              |
| **Images**            | Re-uploaded to Onset, so they keep working after you shut down Beamer.            |
| **Dates**             | The original post date becomes the release date.                                  |
| **Status**            | Published posts arrive as published releases; unpublished posts arrive as drafts. |
| **Pinned posts**      | Stay pinned.                                                                      |
| **URLs**              | The slug from the Beamer post URL is reused, so paths carry over.                 |

Not imported: labels, projects, reactions, feedback, comments, segments and targeting rules, and your Beamer audience. [Import subscribers separately](/guides/subscribers/import) from a CSV.

## Translations

Beamer posts can hold several translations. Onset imports one version per post: the **English** translation if there is one, otherwise the first translation on the post. Other languages are skipped, so check any posts you maintain in multiple languages.

## Re-running the import

Safe. Releases are matched on their slug, and anything already in your workspace is skipped rather than duplicated. If a first pass only caught part of your history, run it again.

## Next steps

See [After importing](/guides/releases/import#after-importing) for what's worth cleaning up before you announce the move.