Preferences migration in Adobe XD
Troubleshooting instructions to resolve preferences migration issues when you update XD

Updating Issue

When updating XD,  user preferences are automatically migrated. In some cases, due to permission issues, the preference migration fails in the backend and a notification appears. 

Preference migration failure notification
Preference migration failure notification

Solution

  1. Quit the Adobe XD app.

  2. In the User Library folder:

    1. Click Cmd+Shift+G from the Mac desktop (or Finder > Go > Go to Folder).
    2. Type in ~/Library to temporarily access the Library directory in the Finder.
    3. Navigate to ~/Library/Application Support/Adobe.
  3. Locate and delete the folder named Adobe XD.

  4. Rename the folder Adobe XD CC to Adobe XD.

  5. In the User Library folder:

    1. Click Cmd+Shift+G from the Mac desktop (or Finder > Go > Go to Folder)
    2. Type in ~/Library to temporarily access the Library directory in the Finder.
    3. Navigate to ~/Library/Application Support.
  6. Delete the folder Adobe.XD.

  7. Rename the folder Adobe.CC.XD to Adobe.XD.

Downgrading Issue

When you downgrade from the latest version of Adobe XD starting from XD 18.0 to any of the previous XD versions, the preferences are not migrated.  You know the migration has failed when the changes made to the document are not shown in the Recent section of the Welcome screen.

Solution

  1. Quit the Adobe XD App.

  2. In the User Library folder:

    1. Click Cmd+Shift+G from the Mac desktop (or Finder > Go > Go to Folder).
    2. Type in ~/Library to temporarily access the Library directory in the Finder.
    3. Navigate to ~/Library/Application Support/Adobe.
  3. Locate and delete the folder named Adobe XD CC.

  4. Rename the folder named Adobe XD to Adobe XD CC.

  5. In the User Library folder:

    1. Click Cmd+Shift+G from the Mac desktop (or Finder > Go > Go to Folder). 
    2. Type in ~/Library to temporarily access the Library directory in the Finder.
    3. Navigate to ~/Library/Application Support.
  6. Delete the Folder by Adobe.CC.XD.

  7. Rename the Folder Adobe.XD to Adobe.CC.XD.