Migration guide

How to Migrate from SugarAI to Attio

By WeekCRM editorial team · · Sources reviewed 2026-11-20 · Editorial policy & disclosures

Move SugarAI (formerly SugarCRM) accounts, contacts, leads and opportunities into Attio: the export limits, the Import2 route and the work SugarAI customisation adds.

Difficulty
Depends on customisation and record volume
Typical duration
Estimate after a representative sample
Downtime
None needed if you freeze edits between the sample and the final import
Native importer
Import2 (SugarCRM is a listed source on Plus, Pro, Enterprise and Ultra plans); CSV is the alternative
How SugarAI records land in Attio
SugarAI maps to Attio What to watch
Account Company Attio matches companies by domain and needs a valid root domain. Check the website field.
Contact Person Attio matches people by email. Sugar links contacts to accounts and to a Reports To contact; the second link needs your own design.
Lead Person, or entry on a list Sugar keeps Leads as their own module and links them to contacts through conversion. Decide whether unconverted leads become people on a prospecting list.
Opportunity Deal In Sugar, opportunity amounts come from Revenue Line Items. Export them together or amounts are empty.
Revenue Line Item Deal attribute Fold the amount, date and stage onto the deal or keep one deal per line item.
Note, Call, Meeting, Task Note or task Sugar links these to a parent by ID. Notes and tasks are Import2 data types; check parent links in the sample.
Custom module (Studio) Custom object Import2 matches custom objects by name or creates them. Audit which modules hold live data first.

What transfers cleanly

  • Accounts, contacts, leads and opportunities, including custom fields you map.
  • Notes and tasks through Import2, validated against their parents.
  • Associations between people and companies.

What doesn't come across

  • Sugar list-view Select All takes the first 1,000 records; larger modules need filtered batches or a report.
  • List-view export gives every field in the module and no subpanel data, so related-module data needs a report.
  • Large exports can time out because of PHP memory limits; export in smaller batches.
  • An administrator can block export for a role under Admin, so check permissions first.
  • Import2 does not update attributes on Attio records that already exist.

Migration order that works

  1. Ask the Sugar administrator to confirm you have export rights and list the modules with real data.
  2. Export Accounts, Contacts, Leads and Opportunities in batches of up to 1,000 from the list view, or build a report for the related data.
  3. Export Revenue Line Items so opportunity amounts survive.
  4. Decide how leads and the Reports To contact link will be modelled in Attio.
  5. Enable Deals in Attio and create stages.
  6. Run an Import2 sample and compare 10 contacts, 10 opportunities with their amounts and the notes on each.
  7. Run the full import and confirm opportunity totals with sales owners.

Export in batches, from the right place

Sugar's list view exports every stock and custom field of the selected module and nothing from subpanels. Select All takes the first 1,000 records, so a module with 40,000 contacts needs 40 filtered passes, or one report. Reports export only the fields you configure, and can include related-module data. If an export times out, shrink the batch.

Leads and opportunities need decisions

Sugar's Leads are a separate module, linked to contacts and opportunities by conversion. Attio takes people. Choose whether unconverted leads become people on a prospecting list. For opportunities, the amount lives on Revenue Line Items, so export those with the opportunities and decide whether a deal holds one line or several.

What Import2 will and will not touch

Import2 is free for workspace admins on Plus, Pro, Enterprise and Ultra. It creates records, notes and tasks, matches existing people by email and companies by domain, and leaves attribute values on existing records untouched. Values migrated into enriched attributes stop Attio from enriching them. Run the sample into a clean workspace, then check phone numbers, which need a country code, and any invalid emails.

Done for you, by Craftt

Need help moving from SugarAI to Attio?

Craftt, the CRM team behind weekcrm, plans and runs the migration: field mapping, deduplication, history and a cutover your team won't notice. You get a fixed quote within one business day.

Frequently asked questions

Is SugarCRM a supported Import2 source?
Yes. Attio's migration page lists SugarCRM. SugarAI is the current name of the same vendor. Check your edition in the sample run.
How many records can I export at once?
In a Sugar list view, Select All takes the first 1,000 records. For more, filter with Module Search and export in batches, or use a report.
Why are my opportunity amounts empty?
Sugar's import documentation says opportunities need Revenue Line Items to populate amounts. Export and map them.
What about Studio custom modules?
Import2 matches custom objects by name or creates them, but module logic does not travel. Rebuild any workflow you still use.