READ ME - Shelf & Asset migration

[Jerc]

After the release of version 7.2, the preferences and Shelf location have changed in order to make them common across the multiple versions of the application (Substance 3D standalone, Steam and Creative Cloud Desktop). This change means previous preferences and custom resources are now ignored by default (but not lost). Since the Shelf has been renamed Assets, the migration involves a few steps detailed below.

How to migrate the Shelf content

The old Shelf content is just files on the disk, so migrating them is just about putting these files in the right place.

• Close the application
  
• Navigate to the old Shelf folder
  (C:\Users\username\Documents\Allegorithmic\Substance Painter)
  
• Copy or cut the sub-folders (alphas, procedurals, materials, etc)
  
• Navigate to the new Assets folder
  (C:\Users\username\Documents\Adobe\Adobe Substance 3D Painter)
  
• Paste the sub-folders you previously copied inside the Assets folder, overwrite if prompted to do so.

Now restart the application, the content should now appear in the Assets window.

Make sure to copy the sub-folders and not just the parent folder of the resources. The parent folder has been renamed from shelf to assets, so copying just the parent folder won't make the resources visible to the application.

How to migrate the Shelf presets

Shelf presets are saved inside a configuration file. To migrate these presets:

• Close the application
  
• Navigate to the old Shelf folder
  (C:\Users\username\Documents\Allegorithmic\Substance Painter)
  
• Copy or cut the Shelf.ini file
  
• Navigate to the new Assets folder
  (C:\Users\username\Documents\Adobe\Adobe Substance 3D Painter)
  
• Paste the file and overwrite the existing one

Now restart the application, the saved searches should appear in the dedicated section or the Assets window.

You can find more information in the Painter Documentation[substance3d.adobe.com].

[Fungi]

Thanks for pinning this at the top!

[Mark3]

Maybe next time, build the damn migration process into the installer, instead of leaving users to search the internet for a solution until you belatedly add a post a week later to the steam forums. It's not as if Adobe can't afford the work of a single coder for the half a day that it would take to implement this is it?