Technology1 min read

Project Setup: What’s In and What’s Next

By · Published by Everything Blog

In short

The opt-in Project Setup system identifies workspaces via a dedicated root configuration file and takes precedence over standard user preferences. It introduces dynamic path templates, custom splash screens, and project-specific OpenColorIO color management settings to maintain visual consistency. Future iterations in version 5.4 will expand this framework by adding localized add-on repositories and broader variable support across interface paths.

Key points

  • Project configurations override standard global user preferences and support external scr…: Project configurations override standard global user preferences and support external scripting through plain files.
  • Version 5.4 plans to introduce per-project extension repositories to localize add-on inst…: Version 5.4 plans to introduce per-project extension repositories to localize add-on installations and settings.
  • Planned multi-project updates include File Browser selectors and constraints to keep save…: Planned multi-project updates include File Browser selectors and constraints to keep save operations inside the active project.

Sources checked by our analysis pipeline: 1

Blender’s preferences used to be shared across all projects, and it was up to users and teams to keep related files and resources tidy and organized.

Blender 5.3 introduces Project Setup, an opt-in system that lets users define settings, asset libraries and shared variables unique to each project they work on.

What is a project?

A project is a root directory that groups related files, lets them share resources, and keeps its settings separate from other projects. The root directory is identified by there being a .blender_project

folder inside it, which contains a configuration file (project.toml

) created and managed by Blender.

When you open a .blend

file, Blender searches up the .blend

file’s folder tree for a .blender_project folder

. If it finds one, that project becomes active. Otherwise it considers the current session to not be part of a project.

It is also possible to open a project by either supplying a folder path to Blender on startup that lies within a project. I.E. blender /path/to/my/project

. This can be done from within Blender itself via the File…

Technology