Skip to content

Compatibility Changes

Some of the changes in Blender significantly break backward compatibility or forward compatibility.

Here you can find the major breaking changes introduced by the recent releases of Blender, as well as the ones planned for future releases. These are collected from the individual release notes and design tasks.

Upcoming Releases

Blender 6.0 — November 2027
Blender 5.3 — November 2026 (alpha)

Published Releases

Blender 5.2 LTS — July 2026 - July 2028

Python API for Geometry Nodes Modifiers

A major refactor of how 'public' properties of a geometry node are exposed/proxied to the modifier and its UI will break all RNA paths to these properties. Essentially, the 'IDProperty' paths (like object.modifiers["geonode_mod"]["socket_1"][1]) will be replaced by real RNA properties, giving paths like object.modifiers["geonode_mod"].socket_1.y.

Node Tools

Node Tools meta-data for asset data has been updated. This requires opening and re-saving asset files similarly to 5.1.

Blender 5.1 — March 2026

Libraries

Libraries have been upgraded to match VFX platform 2026.

Node Tools

Node Tools now have a global unique idname requirement. This can be set automatically by opening and saving files in 5.1, or chosen manually in the node editor header.

Grease Pencil

Grease Pencil fills have been revamped. Blend-files are automatically converted to the new system but some procedural setups using Geometry Nodes and Grease Pencil materials might need manual adjustments. See the Grease Pencil section for more details.

Blender 5.0 — November 2025

Changes to Low-Level Blendfile Format

Several refactors and improvements required deep changes in the blendfile format, which makes it fully incompatible with older versions of Blender.

Blendfiles created with Blender 5.0 and later can only be opened by Blender 4.5 or later. Older Blender versions will report them as invalid.

Increase Maximum Data-Block Names Length

The maximum data-block names length has been increased from 63 to 255 bytes. This allows using names of roughly up to 250 characters (with Latin alphabet), 125 characters (non-latin alphabets, like Arabic, Hebrew, Cyrillic...), and so on.

While some level of forward compatibility has been kept in Blender 4.5 for such long names (by ensuring they are shortened back within 4.5 limits of 63 bytes), some things are not possible. E.g. in Blender 4.5, linking from 5.x blendfiles using longer data-block names is not possible.

Packed Data

Packed IDs remain considered as linked data (i.e. they cannot be edited), but they are stored in the current blendfile.

Compatibility wise, 5.0+ blendfiles containing packed data will open in Blender 4.5LTS, packed data will be converted to plain regular local data then (as if they had been appended).

Remove Intel Mac support

Due to the high maintenance cost of tracking down and fixing graphics related issues specific to Intel and AMD GPU Macs, it was decided to stop maintaining that platforms, and so Blender 5.0 and above will not ship with a Intel build on macOS.

Users are free to continue building their own Intel macOS builds of Blender, and contribute non-intrusive patches to fix issues specific to the platform. However these builds are not officially supported by the Blender Foundation.

Increased minimum GPU requirements for Blender

Due to the lack of official support from GPU vendors for older GPUs, the minimum GPU requirements for running Blender on Windows and Linux has been increased.

  • NVIDIA: Maxwell Architecture (Geforce 900, Quadro MXXXX series, Tesla MXX series) or newer.
  • AMD: GCN 4th generation (Radeon RX 400 series) or newer.
  • Intel: Kaby Lake GPUs ((HD/UHD 6XX) or newer.

Older GPUs may still work, but support will not be provided for them. Community patches to fix bugs on unsupported GPUs are welcome as long as they are not too invasive.

The minimum supported macOS version has been increased to macOS 13.

Blendfile Compression Enabled by Default

Blendfile Compression on saving is now enabled by default (PR#146172, 00dbb53131). Users who still want to write uncompressed blendfiles by default will have to edit and save again their user preferences.

Remove Big-Endian Support

This type of architecture is virtually nonexistent nowadays on Blender hardware targets. It has not been officially supported for years, and the existing code was essentially untested on these platforms.

Theme Updates

Theme options were drastically reduced to make creating custom themes easier and more consistent. Custom themes saved in older versions of Blender are not carried over and need to be manually updated. API for themes are also chaged.

Remove Collada I/O Support

Due to lack of support and maintenance for this format, it has been removed.

Many breaking changes are expected in Blender's Python API. The most notable ones are also listed below.

IDProperties

Direct 'dict-like' access to runtime-defined properties storage has been removed.

UI API

In particular, several features from the UIList may be removed.

Blender 4.5 LTS — July 2025 - July 2027

Deprecate Intel Mac support

Due to the high maintenance cost of tracking down and fixing graphics related issues specific to Intel and AMD GPU Macs, it was decided that this will be the last release with an official Intel macOS build of Blender.

Deprecate Big-Endian Support

This type of architecture is virtually nonexistent nowadays on Blender hardware targets. It has not been officially supported for years, and the current code is essentially untested on these platforms.

This release will be the last one able to open (very!) old blendfiles saved on Big-Endian architectures, and will warn the user about it when such a file is loaded.

Tracked by #125759.


Archived Releases (3.3 - 4.4)

Blender 4.4 — Mar 2025

Cycles

  • The minimum ROCm version required to use HIP on AMD GPUs has increased to 6.0.

Pipeline & I/O

  • Alembic/USD: The processing of edge and vertex crease values has been changed to respect the range of values expected by OpenSubdiv. For subdivision surface assets using creases produced in prior versions, a backward compatible transform will be applied when loading into 4.4. However, files produced in 4.4 and loaded into prior versions might need to be reworked.

Python API

  • Code defining custom __init__/__new__ functions for sub-classes of Blender-defined types (like Operator, PropertyGroup, RenderEngine...) must now call the parent matching function.
  • The bpy.types.Sequence and all related types got renamed to bpy.types.Strip. See the full list of changes.

Animation: Slotted Actions

  • Assigning an Action might not be enough to animate the data-block. To ensure that, also assign an action slot.
Blender 4.3 — Nov 2024

Cycles

  • Support for AMD and Intel GPUs through the Metal backend on macOS has been removed.
  • The minimum driver version requirement for NVidia GPUs has been increased to 495.89
  • Support for Vega in Cycles AMD HIP backend has been removed

Grease Pencil

The Grease Pencil type of object has been rewritten to allow deeper changes, removing long standing limitations and facilitating future evolutions. Read about the Migration Process from previous versions. The new data model will be fully incompatible with previous Blender releases.

Brush Assets

The brush workflow has been redesigned to use global brush asset libraries. Brushes from previous versions need conversion.

Python API

The AttributeGroup type was split into one new type per attribute owner.

Blender 4.2 LTS — Jul 2024 - Jul 2026

EEVEE

The EEVEE render engine was completely rewritten. Read about the Migration Process from previous versions. Some platforms and hardware are not working as expected yet, see the Platform Compatibility section for details.

Compositor

The Compositor now supports GPU rendering. Due to this, a number of changes were done to the way the canvas is computed, and some nodes have been adapted to support both CPU and GPU. See the list of breaking changes.

Add-ons and Themes

Most add-ons that used to ship with Blender, are now available on the Extensions Platform where you can browse, install, and update them online from within Blender.

SSE4.2 CPU

On Windows and Linux a CPU with SSE4.2 is now required. This is supported since AMD Bulldozer (2011) and Intel Nehalem (2008).

Statically Typed IDProperties

System-defined and library-overridable IDProperties are now statically typed.

Blender 4.1 — Mar 2024

Auto Smooth

The "Auto Smooth" option has been replaced by a modifier node group asset.

Apple

macOS 11.2 (Big Sur) is now the minimum required version for Apple computers. This is required for the Metal backend to work correctly.

Libraries

Libraries have been upgraded to match VFX platform 2024.

Blender 4.0 — Nov 2023

Blend Files

The mesh format changes from previous versions are now included in the Blender file format. Blender 3.6 LTS can read files saved with 4.0, and will save meshes in a format compatible with older versions of Blender.

Unused Linked Data

Unused linked data is not kept anymore when saving and re-opening .blend files.

Graphics Cards

The minimum required OpenGL version has been increased to 4.3 for Linux and Windows. On macOS only Metal is supported now.

Support for Intel HD4000 series GPUs has been dropped.

Bone Collections

New bone collections replace both legacy numbered layers and bone groups.

Blender 3.6 LTS — Jun 2023 - Jun 2025

There are no significant compatibility changes in this release.

Blender 3.5 — Mar 2023

New Minimum Requirements

  • macOS - macOS 10.15 (Catalina) for Intel devices - macOS 11.0 (Big Sur) remain the minimum for for Apple Silicon.
  • Linux distribution with glibc 2.28, including: - Ubuntu 18.10 - Debian 10 (Buster) - Fedora 29 - RHEL 8 and derivatives CentOS, Rocky Linux and AlmaLinux

Libraries

Libraries have been upgraded to match VFX platform 2023.

Blender 3.4 — Dec 2022

Nodes

The Transfer Attribute node has been split into three separate nodes.

The MixRGB nodes for Shader and Geometry Nodes are converted to the new "Mix Node" on loading. Files saved with the new node are not forward compatible with older versions of Blender.

Because of asset support in node editor 'Add' menus, node group asset files must be re-saved in version 3.4.

Blender 3.3 LTS — Sep 2022 - Sep 2024

There are no significant compatibility changes in this release.