---
title: "axiom import"
description: "Import proto definitions from a published package"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, guides/import-package-types]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom import

Import proto definitions from a published package

Download .proto files from a published Axiom package into gen/imports/.

The imported message types become available for use as node inputs/outputs
in this package. An entry is added to imports: in axiom.yaml, and
axiom generate is run so the IDE and compiler immediately see the new types.

When @version is omitted, the most recently published version is imported.

Requires a prior "axiom login".

Examples:
```text
axiom import payments
axiom import payments@2.0.1
```

## Usage

```sh
axiom import <package>[@version] [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for import |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- Guide: [Import package types](../../guides/import-package-types.md)