Adding shelf presets manually

Assets search queries (or Shelf presets) can be defined by editing a configuration file. This page explains how.

Location of the configuration file

In order to add custom saved queries, navigate to the to the user's Documents folder and open the Shelf.ini file.

PlatformVersionPath
Windows7.2 or newerC:\Users\username\Documents\Adobe\Adobe Substance 3D Painter
LegacyC:\Users\username\Documents\Allegorithmic\Substance Painter
Mac7.2 or newer/Users/username/Documents/Adobe/Adobe Substance 3D Painter
Legacy/Users/username/Documents/Allegorithmic/Substance Painter
Linux7.2 or newer/home/username/Documents/Adobe/Adobe Substance 3D Painter
Legacy/home/username/Documents/Allegorithmic/Substance Painter

Example

Below is an exmaple of content that can be put in the configuration file:

[filters]
size=4
1\name=Grunge
1\query="u:basematerial=,smartmaterial=,smartmask=,texture=,procedural=,brush=,alpha= grunge"
2\name=Procedural
2\query="u:procedural="
3\name=Environment
3\query="u:environment="
4\name=Default Filters
4\query="p:/allegorithmic/^ u:filters="
Here is how the syntax works:

  • Size: is determines the number of custom presets that need to be read and loaded by the application.
  • Number: at the start of the line defines the current preset it targets (ex: 1/).
  • Query: (after the number) defines the actual search terms used. In the example it uses u: for usages, p: for paths, or a string for a search term. The query content has to be wrapped in quotes. To learn about the terms that can be used, see this page.
  • Name: the named of the preset.