How to Troubleshoot Issues with the Migration Assistant After Upgrading to KeyShot 2024

What to Do If You Aren’t Prompted to Use the Migration Assistant After Upgrading to KeyShot 2024

Issue

Users may encounter an issue with the Migration Assistant not working when upgrading to KeyShot 2024.

Environment Details

• KeyShot 2024

Resolution

When you install a new version of KeyShot and open it for the first time, you should have the opportunity to migrate all your resources and settings to the newer version.

The Migration Assistant should pop up if you have the previous version of KeyShot installed on the same device. If it did not appear, you can retry setting up KeyShot 2024 to prompt you for migration by following the steps below.

Delete the Settings.xml File

Mac Instructions:

1. Click on "Go" in the Finder bar, then click on "Computer."
2. Open "Macintosh HD."
3. Open the "Library" folder.
4. Open the "Application Support" folder.
5. Open the "KeyShot [version]" folder.
6. Look for the KS[version]Settings.xml file and delete it.

Windows Instructions:

1. Go to one of the following destinations:
   • C:\Users\Public\Public Documents\KeyShot [version]
   • C:\Users\[YourUserName]\Documents\KeyShot [version]
2. Look for the KS[version]Settings.xml file and delete it.
3. Relaunch KeyShot. If prompted, DO NOT migrate any settings from older versions of KeyShot.

Once the file is deleted, launch KeyShot again. It should ask if you want to migrate the settings and resources from the previous version. If it does not, a fresh install may be necessary.

How to Perform a Fresh Install

Uninstall KeyShot

• Windows: Uninstall through Add/Remove Programs.
• Mac: Uninstall by going to the Applications folder and deleting the KeyShot app.

Make sure to delete the KeyShot resources folder. If you wish to back up your resources, move the folder to the desktop.

• Windows Default Locations:
  • C:\Users\[UserName]\Documents\KeyShot
  • C:\Users\Public\Documents\KeyShot
  • Delete C:\ProgramData\Luxion\KeyShot
  • Delete C:\Users\%username%\AppData\Local\Luxion\KeyShot
• Mac Default Location:
  • /Library/Application Support/KeyShot

Download and Reinstall KeyShot

Download the full installer (not the update installer) from the links below:

• Newest Version of KeyShot
• Older Versions of KeyShot

Go through the registration wizard, enter your license information, and KeyShot should be up and running.

If you have any questions or need further assistance, please contact KeyShot Support.