1. Home
  2. SKILLMERC
  3. How to move from Xero to FreeAgent

How to move from Xero to FreeAgent

There is no one-click way to move from Xero to FreeAgent today. FreeAgent's own imports cover contacts, opening balances and bank transactions. Past invoices and bills are the hard part. This guide shows the manual way, step by step, with FreeAgent's and Xero's own help pages quoted. Checked 21 Nov 2026.

If you have an accountant, involve them early. FreeAgent says it plainly: "Your accountant should be able to advise which entries you need to record in your FreeAgent account. Please note that our support team can't help you with this as we're not authorised by HMRC to provide accounting advice."

1. Pick your FreeAgent start date

This is the day you start keeping your books in FreeAgent. Everything before it comes in as opening balances, not as single transactions. FreeAgent: "you should only import bank transactions, invoices and bills that are dated on or after your FreeAgent start date."

A good choice is the first day of an accounting year or a VAT quarter, so the old system closes a whole period.

2. Export everything from Xero

Xero recommends exporting "your chart of accounts, contacts, invoices, bills and fixed asset list", plus a "Trial Balance including past periods", an "Account Transactions report" and the receivable and payable invoice detail reports (Xero Central, "About exporting data out of Xero"). Contacts, the chart of accounts and invoices and bills export as CSV files.

The one report you cannot skip is the trial balance dated the day before your FreeAgent start date. FreeAgent calls it the most important item on its list.

Keep the whole export even after you move. Xero says you are responsible for keeping records of what you entered.

3. Import your contacts

Customers and suppliers are both "contacts" in FreeAgent. Import them before the opening balances, so you can assign money owed to each one.

FreeAgent imports a CSV file with these 14 headers, in this order: First Name, Last Name, Company, E-mail Address, E-mail 2 Address, Business Street, Business Street 2, Business Street 3, Business City, Business State, Business Postal Code, Business Country, Business Phone, Mobile Phone. "The only compulsory fields are either First Name and Last Name, or Company." You can import "a maximum of 1,000 contacts at a time."

Xero's contact export uses its own column names (for example ContactName, FirstName, LastName, EmailAddress and the postal address columns), so you rename and reorder the columns in a spreadsheet first: Xero's contact name goes under Company, the email address under E-mail Address, and so on. Split the file if you have more than 1,000 contacts.

In FreeAgent: Contacts, then Import Contacts.

4. Import your opening balances

Your opening balances come from the Xero trial balance. FreeAgent has a template for them: Accounting, then Journal Entries, then Opening Balances, then Import Opening Balances. The template has three columns: the FreeAgent category (nominal code), the debit amount and the credit amount.

Two things to watch:

  • Xero's account codes are not FreeAgent's category codes. Download FreeAgent's chart of accounts from the same screen and match each Xero account to a FreeAgent category by hand. FreeAgent lets you add custom categories where nothing fits.
  • "Importing a set of opening balances will overwrite any existing opening balances in your account", and you need full (level 8) access to do it.

Money customers owed you and money you owed suppliers at the start date go in against each contact, so FreeAgent knows who owes what.

5. Bring in bank transactions

The easy route is a bank feed. FreeAgent: it "enables your bank transactions from the last two years to be imported into FreeAgent automatically overnight each night."

For transactions more than two years old, or a bank without a feed, upload bank statements (OFX, QIF or CSV). A CSV needs three columns in this order and no header row: the date as dd/mm/yyyy, the amount with a minus sign for money paid out, and a description.

Bank transactions arrive unexplained. You then explain each one (what it was for), which is where most of the time goes. Once you have explained some, FreeAgent's Guess feature tries to explain new ones for you.

6. Past invoices and bills

This is what FreeAgent's imports do not cover. FreeAgent says you can enter "historical sales invoices or bills (supplier invoices) using a third-party integration such as AutoEntry, Dext, Fabio or Zapier." AutoEntry and Dext read invoice and bill documents. Fabio uploads records in bulk from a CSV file you build, and it is pay as you go with a free trial. None of them connects to Xero and copies your records across.

Your choices:

  • Leave them in Xero (or in your export) and start fresh in FreeAgent from the start date. This is the simplest route. The opening balances carry the totals.
  • Bulk-upload them with Fabio: export invoices and bills from Xero as CSV, reshape the file into the layout Fabio asks for, and upload it.
  • Re-enter open (unpaid) invoices and bills by hand, so you can mark them paid in FreeAgent when the money arrives.
  • For income only: FreeAgent says you can "upload the relevant bank transactions and explain them as 'Sales'" instead of creating invoices.

7. Check the numbers match

FreeAgent: "compare the figures on your trial balance in FreeAgent with the trial balance or report of all your accounts in your previous system. If they match, you've entered all the relevant data."

What does not move with this method

  • Invoice and bill history line by line (only through re-entry or a third-party tool)
  • Attachments on Xero transactions
  • Payroll history
  • Your Xero bank reconciliations (you explain transactions again in FreeAgent)

We are building a tool for step 6

We are building a self-serve tool that copies customers, suppliers, invoices, bills, bank transactions and opening balances from Xero into FreeAgent. It does not exist yet. If you want it, join the list and we will email you when it is ready to try.

Sources (read 21 Nov 2026)

  • FreeAgent, "A guide to switching to FreeAgent": support.freeagent.com/hc/en-gb/articles/360019910020
  • FreeAgent, "Get started with FreeAgent": support.freeagent.com/hc/en-us/articles/4405955565842
  • FreeAgent, "Import your contacts" and "CSV file formats for importing contacts": support.freeagent.com/hc/en-us/articles/115001222904 and 115001222864
  • FreeAgent, "Import your opening balances": support.freeagent.com/hc/en-us/articles/4411292032018
  • FreeAgent, "Format a CSV file to upload a bank statement": support.freeagent.com/hc/en-us/articles/115001222564
  • FreeAgent integrations, "Fabio": freeagent.com/integrations/fabio/
  • Xero Central, "About exporting data out of Xero": central.xero.com/s/article/Export-data-out-of-Xero-US

SKILLMERC is not affiliated with FreeAgent or Xero.