# @tryghost/mg-curated-members-csv

> Converts the "Subscribers" CSV export from Curated to a CSV compatible with Ghost.

Latest version **0.14.6** (published 2026-08-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @tryghost/mg-curated-members-csv
pnpm add @tryghost/mg-curated-members-csv
yarn add @tryghost/mg-curated-members-csv
bun add @tryghost/mg-curated-members-csv
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.14.6 |
| Published | 2026-08-24 |
| First published | 2021-02-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 5.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 69 |
| Author | Ghost Foundation |
| Maintainers | zimoatghost, allouis, kernalghost, chrisraible, erisds, johnonolan, kevinansfield, cobbspur, aileencgn, jloh, minimaluminium, sam-lord, pauladamdavis, bobvaneck, joeegrigg, hadret, erik-ghost, sagzy, vershwal, zach1618, mike182uk, luissazevedo, lsinger, nickmoreton, renatoworks, rblstr-ghost, evanhahn-ghost, austin.burdine, weylandswart, ghost-slimer, tmciesco, jonatan-ghost, 9larsons |

## Links

- npm: https://www.npmjs.com/package/@tryghost/mg-curated-members-csv
- Repository: https://github.com/TryGhost/migrate
- Homepage: https://github.com/TryGhost/migrate#readme
- Issues: https://github.com/TryGhost/migrate/issues
- npm.io page: https://npm.io/package/@tryghost/mg-curated-members-csv

## Dependencies (1)

- [@tryghost/mg-fs-utils](https://npm.io/package/@tryghost/mg-fs-utils.md) 0.26.6

## Recent versions

- 0.14.6 (latest) — 2026-08-24
- 0.14.5 — 2026-08-19
- 0.14.4 — 2026-08-12
- 0.14.3 — 2026-08-04
- 0.14.2 — 2026-07-15
- 0.14.1 — 2026-07-01
- 0.14.0 — 2026-06-17
- 0.13.0 — 2026-06-04
- 0.12.0 — 2026-05-07
- 0.11.3 — 2026-04-28
- 0.11.2 — 2026-04-28
- 0.11.1 — 2026-04-24
- 0.11.0 — 2026-04-20
- 0.10.0 — 2026-04-16
- 0.9.0 — 2026-04-10
- … 62 more at https://npm.io/package/@tryghost/mg-curated-members-csv/versions

## README

# Curated Ghost CSV Converter

Converts the "Subscribers" CSV export from Curated to a CSV compatible with Ghost.


## Install

To install the CLI, which is required for the Usage commands below:

```sh
npm install --global @tryghost/migrate
```

To use this package in your own project:

`npm install @tryghost/mg-curated-members-csv --save`

or

`pnpm add @tryghost/mg-curated-members-csv`


## Usage

To run a Curated CSV migration, the required command is:

```sh
migrate curated-members --pathToFile /path/to/emails.csv
```

It's possible to pass more options, in order to achieve a better migration file for Ghost:

- **`--pathToFile`** (required)
    - Path to the signups CSV file as generated by Curated
    - string - default: `null`
- **`-V` `--verbose`**
    - Show verbose output
    - bool - default: `false`
- **`-l` `--limit`**
    - Define the batch limit for import files
    - int - default: `5000`
- **`--freeLabel`**
    - Provide a label for Curated `free` subscribers
    - string - default: `curated-free`
- **`--cache`** 
    - Persist local cache after migration is complete (Only if `--zip` is `true`)
    - bool - default: `true`

A more complex migration command that accounts for Stripe data could look like this:

```sh
migrate curated-members emails.csv --freeLabel Newsletter --limit 1000
```


## Develop

This is a mono repository, managed with [Nx](https://nx.dev/) and pnpm workspaces.

Follow the instructions for the top-level repo.
1. `git clone` this repo & `cd` into it as usual
2. Run `pnpm install` to install top-level dependencies.


### Run

To run a local development copy, `cd` into this directory, and use `pnpm dev` instead of `migrate` like so:

```sh
pnpm dev curated-members --pathToFile /path/to/emails.csv
```


## Test

- `pnpm test` runs the package tests
- Linting and formatting are run from the repo root (`pnpm lint`, `pnpm format`)


# Copyright & License

Copyright (c) 2013-2026 Ghost Foundation - Released under the [MIT license](LICENSE).

---
_Source: https://npm.io/package/@tryghost/mg-curated-members-csv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._