Estructura de directorios de Blender

This page documents the different directories used by Blender.

This can be helpful for troubleshooting, automation and customization.

User Directories

User directories store preferences, startup file, installed extensions, presets and more. By default these use the standard configuration folders for each operating system.



If the $XDG_CONFIG_HOME environment variable is set:



/Users/$USER/Library/Application Support/Blender/4.3/


%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.3\

Portable Installation

When running Blender from a portable drive, it’s possible to keep the configuration files on the same drive to take with you.

To enable this, create a folder named portable at the following locations:

  • Windows: Next to the Blender executable, in the unzipped folder

  • Linux: Next to the Blender executable, in the unzipped folder

  • macOS: Inside the application bundle at

This folder will then store preferences, startup file, installed extensions and presets.

Variables de entorno

The BLENDER_USER_RESOURCES environment variable can be set to a custom directory to replace the default user directory.

System Directories

System directories store files that come bundled with Blender and are required for it to function. This includes scripts, presets, essential assets and more.


Archive downloaded from


Linux distribution packages:





Zip file downloaded from


Installer downloaded from

%ProgramFiles%\Blender Foundation\Blender\4.3\

Microsoft Store installation:


Variables de entorno

BLENDER_SYSTEM_SCRIPTS and BLENDER_SYSTEM_EXTENSIONS environment variables can be used to bundle additional scripts and extensions, that are not part of the regular Blender installation.

Other BLENDER_SYSTEM environment variables can override other system paths, though are not commonly used in practice.

Estructura de rutas


Ubicación de autoguardado para el archivo blend (solo para usuarios de Windows, en otros sistemas se utiliza el directorio temporal).

Located in user directories.


User configuration and session info.

Located in user directories.


Blend file to load on startup.


User preferences.


Marcadores del Explorador de archivos.


Lista del menú de archivos recientes.


Startup file for an application template.


User preferences file for an application template.


Data files loaded at runtime.

Located in both user and system directories. User data files either override or add to system data files.


Default OpenColorIO configuration.


User interface fonts.


Studio light images for 3D viewport.


Extension repositories.

Located in both user and system directories. Repositories are loaded from both directories.


Add-ons, presets, templates, user interface, startup scripts.

Located in both user and system directories. Scripts are loaded from both directories.


Los complementos Python que podrán ser habilitados en las Preferencias, incluyen soporte para la importación/exportación de formatos, integración de motores de procesamiento y muchas utilidades prácticas.


Módulos para ser utilizados por los complementos (agregados al sys.path de Python).


The add-ons directory which is used for bundled add-ons.


Modules for addons_core to use (added to Python’s sys.path when it found).


Módulos de Python que contienen el núcleo de nuestra API y funciones de utilidades para que puedan importar otros scripts (agregados al sys.path de Python).


Scripts que son automáticamente importados en el arranque.


Application templates installed in user directories.


pplication templates automatically loaded from system directories.


Ajustes predefinidos usados para almacenar opciones definidas por el usuario para telas, formatos de procesamiento, etc.


Scripts de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Python.


Shaders OSL de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Open Shading Language.


Distribución Python incorporada.

Located in system directories.

Directorio local de cachés

The cache directory is used to store persistent caches locally. Currently it is only used for the indexing of Asset Libraries. The operating system is not expected to clear this automatically.

La siguiente ruta será usada:

  • Linux:

    $XDG_CACHE_HOME/blender/ si $XDG_CACHE_HOME se encontrara definida, en caso contrario será $HOME/.cache/blender/

  • macOS:


  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Directorio temporal

El directorio temporal se usará para almacenar varios archivos durante la ejecución (incluyendo capas de procesamiento, caché de dinámicas, buffer de copiar/pegar y registros de errores).

El directorio temporal se selecciona basado en la siguiente prioridad:

  • Preferencias de Usuario (véase Rutas de archivos).

  • Variables de entorno (TEMP en Windows, TMP y TMP_DIR en otras plataformas).

  • El directorio /tmp/.