# Back up, restore and import your data

Your AppNorth workspace lives on your Mac. Export and restore backups, move to a new Mac, and import keywords from Astro, App Sprint or a CSV file.

Source: https://www.appnorth.app/docs/backup-and-import (2026-11-12)

## Where your data lives

Everything stays on your Mac, in `~/Library/Application Support/@appnorth/desktop`: apps, keywords, history, drafts and settings. There is no AppNorth account or cloud copy.

Keys for Apple, Google and DeepL are encrypted with a key kept in your macOS Keychain. They are never part of a backup.

## Back up and restore

1. Open **Settings → General → Data** and click **Export Backup…**. AppNorth saves `appnorth-backup.json` with your folders, apps, keywords, tags, rank and popularity history, listing changes and country order.
2. To restore, click **Restore Backup…** in the same place and choose the file.
3. Confirm **Replace All Local Data?**. The backup replaces the whole workspace on this Mac.

> A backup from a newer version of AppNorth can’t be restored into an older one. Update AppNorth first.

## Move to a new Mac

1. On the old Mac, export a backup, then click **Deactivate This Mac** in **Settings → License**.
2. Install AppNorth on the new Mac and activate your license. See [Install and activate](https://www.appnorth.app/docs/install).
3. Restore the backup, then enter your keys again in **Settings**.

## Import from Astro

1. In **Keywords**, open **More Actions** and choose **Import from Astro…**.
2. Choose **Use local Astro data** to read Astro on this Mac, or **Choose File…** for an Astro CSV export. Allow access if macOS asks.
3. Choose the folder for new apps, **Research** or **My apps**, and click **Import**.
4. Open **App facts & imports** and add the keywords you want to track. Imported phrases aren’t tracked automatically.

> Astro’s popularity is saved as Astro (Apple Ads) evidence with its date, apart from AppNorth’s own measurements.

## Import from App Sprint

Choose **Import from App Sprint** in **More Actions**, or in **Settings → General → Data**. Select the `AppSprintASO` folder in `Library/Application Support`, or a copy of it.

AppNorth adds your apps and keywords, keeps the keywords and notes you already have, tags liked keywords **Liked** and then checks the keywords as usual. App Sprint’s popularity estimates, difficulty and top-25 ranks are kept as imported evidence and never replace Apple Ads popularity.

## CSV files

- Keywords: **Import CSV or Text…** and **Export All Stores to CSV…** in **More Actions**.
- Listings: **Import Metadata CSV…** and **Export Metadata CSV…** in the manual editor of **App Store page**.
- Prices: **Import CSV…** and **Export CSV…** in the **Localize** tab of **Pricing**.

## Questions

### Does AppNorth sync between my Macs?

There is no cloud sync. Use a backup to move your data, or share this workspace with a paired Mac on your network from **Settings → Other computers**.

### Are my keys in the backup?

No. Backups never include credentials. Enter them again after you restore.

### Do I need my Astro or App Sprint account to import?

No. AppNorth reads their data on this Mac or an export file. It never reads App Sprint credentials.
