Render Subdivision Levels

Checks for Subdivision Surface modifiers whose render subdivision level is significantly higher than the configured maximum or the modifier's viewport subdivision level. If the viewport level is already above the configured maximum, only the relative render-vs-viewport limit is enforced, since this check never recommends lowering render quality below viewport quality.

Warning Automatic fix: Yes Settings: Yes Selection: Object

Why this check exists

Prevents sudden system memory exhaustion, long render freezes, and application crashes. Each extra subdivision level multiplies face counts exponentially, meaning a high render level can silently turn a light scene into a gigabyte-heavy monster during final export.

Behavior

Module	`rendering/render_subdivision_levels.py`
Included with	Core
Severity	Warning
Automatic fix	Yes
Fix behavior	An automatic fix is available.
User settings	Yes
Selection support	Object

Settings

Setting	ID	Type	Default	Description
Maximum Render Levels	`maximum_render_levels`	int	3	Fail when a Subdivision Surface modifier's render level is above this value, unless the viewport subdivision level is already above the configured maximum. Min: · Max: 12
Maximum Levels Above Viewport	`maximum_levels_above_viewport`	int	1	Maximum allowed difference between the render level and viewport level. Min: · Max: 12
Ignore Disabled Render Modifiers	`ignore_disabled_render_modifiers`	bool	True	Ignore Subdivision Surface modifiers that are disabled for rendering.
Include Simple Subdivision	`include_simple_subdivision`	bool	True	Also check Subdivision Surface modifiers using the Simple subdivision method.