Skip to content

Importing Subscriptions and Master Data in "Subscriptions"

Last updated: November 15, 2026

A company starts using "Subscriptions" with hundreds of subscriptions in spreadsheets and an old system, and each customer has past cycles and others running now. Entering them one by one takes days, and every mistake in a quantity or a date shows up later on the invoices.

Importing brings them over at once from files with a fixed template, and checks every row before creating anything: what's right is imported, and what has a problem is held back with its rows for you to fix and import afterwards. The whole import can be undone if a mistake shows up.

Follow the Steps

Each kind is imported from its own list, and a subscription needs its customer and plan to exist before it:

  • Products: one file.
  • Customers: one file.
  • Plans: two files, "Plans" and "Plan Products", so products are imported before them.
  • Subscriptions: three files, "Subscriptions", "Cycles" and "Cycle Lines", so customers and plans are imported before them.

If what the import needs isn't there yet, a message shows, like: "There are no customers or plans yet. Import them first."

Uploading the Subscription Files

Importing subscriptions starts with choosing what you're importing, then the three files:

  • Choose "Subscriptions" from the side menu, then click "Import".
  • In "What are you importing?", choose "Current" or "Historical".
  • If you don't have the template, click "Download CSV" or "Download Excel", and fill it.
  • Click "Choose a file" for each of the three files, or drag and drop it, then click "Continue".
  • Current: today's subscriptions and cycles. They are checked like the forms: end dates, prices, quantities and currencies.
  • Historical: cycles that ended before the Subscriptions start date. They are taken as written. Nothing is invoiced and no revenue is deferred.

Under each file is "Columns": each column's name, whether it's required, and what it takes. "Cycle Name" links the cycle lines to their cycle, and "Edara" names the cycle itself on import. A file is CSV or Excel up to 10 MB, and an Excel file with a tab for each file fills them all at once.

Check, Preview and Undo

Before any subscription is created, the files are checked and what will be imported is shown:

  • In "Check", look over "Ready to import" and "Held back", and the problems table.
  • Click "Download held-back rows" if you want to fix them, then "Continue".
  • In "Preview", look over the subscriptions as they will look, then click "Import".

The problems table has "File", "Row", "Column" and "Problem", like a customer that doesn't exist or a quantity more than the plan allows. A subscription with a problem is held back whole, with all its rows, and the rest is imported. Held-back rows download in the template's shape with a "Problem" column, so you fix them and import them alone.

After the import, "Import finished" shows with how many were created and held back. Click "Undo this import" to remove everything it created. It is offered until you leave the page.

Important Things to Know

  • Importing only adds: a name that already exists is a problem and its row is held back, and nothing existing is updated.
  • Columns not in the template are not imported.
  • A Current file can continue a subscription that a Historical import brought in. The Subscriptions start date is in Settings. See Getting Started with "Subscriptions" and Understanding Cycles.
  • In the "Cycles" file, Yes in the Invoiced column means the cycle was invoiced before, so no document is created for it.

Try It Yourself

Sample data — it doesn't affect any real data. Click "Import" in "Subscriptions", choose the three files, then compare what's held back in "Current" and in "Historical".

You May Be Wondering

In what order do I import the data?
Products, then customers and plans, then subscriptions.
What happens to a subscription with a problem?
It's held back whole, with all its rows, and not imported, and the rest is imported. Download the held-back rows, fix them, and import them alone.
Are historical cycles invoiced?
No. They are taken as written, nothing is invoiced and no revenue is deferred.
Can an import made by mistake be undone?
Yes. Click "Undo this import" before leaving the page, and everything it created is removed.

If you encounter any challenges or have questions during these processes, you can contact our technical support team, who are ready to assist you at any time.