diff --git a/website/docs/addon_core_settings.md b/website/docs/addon_core_settings.md index a1336d92..a11cf4fa 100644 --- a/website/docs/addon_core_settings.md +++ b/website/docs/addon_core_settings.md @@ -99,6 +99,27 @@ Applicable context filters: (This image shows use case where `render` anatomy template is used for products of families ['review, 'render', 'prerender'], `publish` template is chosen for all other.) +### Filter creator profiles + +This feature offers settings that narrow down the list of creators appearing in Publisher according to the specific context, thereby making it easier for artists to choose the right creator for their work. +Each profile consists of +- A list of host names. +- Task Types drop down menu. +- A list of task names, which can serve as an alternative to task types. +- A list of Creator Labels, where you can add the labels of the creators you want to be displayed. + +If you would like to show creator, put its creator label to `Allowed Creator Labels`, easiest way is to open DCC, select creator label in the list of creators and copy&paste it to Settings. +Regular expression is supported (eg. `Image.*` would show all `ImageHD`, `ImageLD`, `ImageThumb` creators). + +Logging is provided in debug mode (`ayon_console --debug`) to highlight if profile matched and filtering is happening. + +![core_tools_filter_creators](assets/tools/core_tools_filter_creators.png) + +::: note +In the example shown above only available creators with labels starting with `Render` (eg. `Render`, `RenderLOD` etc.) for `animation` task started in `AfterEffects`. +No other creators will be shown for use when this filter profile being active. No other DCCs or even tasks in `AfterEffects` would be affected. +::: + #### Custom Staging Directory Profiles With this feature, users can specify a custom data folder path based on presets, which can be used during the creation and publishing stages. diff --git a/website/docs/assets/tools/core_tools_filter_creators.png b/website/docs/assets/tools/core_tools_filter_creators.png new file mode 100644 index 00000000..a20eba67 Binary files /dev/null and b/website/docs/assets/tools/core_tools_filter_creators.png differ