Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Subdivision levels - SculptForge User Guide</title>
<meta name="description" content="Subdivision levels let you sculpt one model at several resolutions: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every Part has its own levels.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/png" sizes="32x32" href="../img/favicon-32.png?v=7">
<link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
<link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
<link rel="canonical" href="https://sculptforge.app/guide/subdivision-levels.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Subdivision levels - SculptForge User Guide">
<meta property="og:description" content="Subdivision levels let you sculpt one model at several resolutions: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every Part has its own levels.">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/subdivision-levels.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=12" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="facial-shapes.html" data-next="micro-levels.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
<nav aria-label="Main">
<a href="../index.html#features">Features</a>
<a href="../index.html#demos">Demos</a>
<a href="../brushes.html">Brushes</a>
<a href="index.html" aria-current="page">Guide</a>
<a class="nav-dl" href="../index.html#download">Download</a>
<a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
<a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
</nav>
</div>
</header>
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
<span>Contents</span><span class="toc-current">Subdivision levels</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
<nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What's new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html" class="current" aria-current="page">Subdivision levels</a><ul class="toc-sections"><li><a href="#add-level">Add Level</a></li><li><a href="#stepping-between-levels">Stepping between levels</a></li><li><a href="#what-follows-the-levels">What follows the levels</a></li><li><a href="#remove-below-and-remove-above">Remove Below and Remove Above</a></li><li><a href="#rebuild-lower-levels">Rebuild Lower Levels</a></li><li><a href="#undo-projects-and-exporting">Undo, projects and exporting</a></li><li><a href="#commands">Commands</a></li><li><a href="#speed-and-memory">Speed and memory</a></li><li><a href="#past-the-highest-level">Past the highest level</a></li></ul></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="subdivision-levels">Subdivision levels</h1>
<p>Subdivision levels let you sculpt one model at several resolutions: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every Part has its own levels.</p>
<figure class="shot"><a href="images/subdivision-levels.jpg" class="zoom"><img src="images/subdivision-levels.jpg" alt="A cube cage, a middle level and the top level of the same sculpt" width="1200" height="370" loading="lazy" decoding="async"></a><figcaption>A cube cage, a middle level and the top level of the same sculpt</figcaption></figure>
<p>Everything is in the <strong>Levels</strong> group at the top of <strong>Tool > Geometry</strong>, in the order you use it:</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>Shortcut</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Level</strong> slider</td><td></td><td>Steps to any level (1 is the base cage)</td></tr><tr><td><strong>Lower Level</strong></td><td><kbd>Shift</kbd>+<kbd>D</kbd></td><td>Steps one level down</td></tr><tr><td><strong>Higher Level</strong></td><td><kbd>D</kbd></td><td>Steps one level up</td></tr><tr><td><strong>Add Level</strong></td><td><kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>Adds a level above the highest one and steps to it</td></tr><tr><td><strong>Smooth</strong></td><td></td><td>Smooths the next new level (on by default)</td></tr><tr><td><strong>Rebuild Lower Levels</strong></td><td></td><td>Finds a lower level for a mesh that was subdivided elsewhere</td></tr><tr><td><strong>Remove Below</strong></td><td></td><td>Deletes the levels below the current one (asks first)</td></tr><tr><td><strong>Remove Above</strong></td><td></td><td>Deletes the levels above the current one (asks first)</td></tr></tbody></table></div>
<p>Under the buttons the palette says where you are ("Level 3 of 5") and how many triangles the base and the top have. The <strong>Part</strong> list shows the level of every Part that has them ("Level 3/5").</p>
<h2 id="add-level">Add Level<a class="anchor" href="#add-level" aria-label="Link to this section">#</a></h2>
<p><strong>Add Level</strong> (<kbd>Ctrl</kbd>+<kbd>D</kbd>) adds a level with four times the polygons. The lower levels stay, so you can step back down at any time.</p>
<ul>
<li>
<strong>Quads stay quads.</strong> A mesh with quads is divided with Catmull-Clark subdivision: each quad becomes four quads, and a triangle among them becomes three quads. A mesh of triangles only (a sphere from <strong>New Sphere</strong>, a scan) is divided with Loop subdivision: each triangle becomes four.
</li>
<li>
<strong>Smooth</strong> (next to Add Level) smooths the new level, rounding off the shape. Turn it off to divide flat: the new level keeps the hard edges and flat faces of the one below, for hard-surface pieces.
</li>
<li>
Add Level always adds the level on top. If you are at a lower level it steps to the highest first.
</li>
<li>
Mask, vertex paint, paint layers and UVs are interpolated onto the new level; face groups and hidden faces carry over; sculpt layers are divided with the shape.
</li>
<li>
How far you can divide depends on your computer's memory: about 160 million triangles with 32 GB (each triangle of a divided model takes about 90 bytes, plus some room while dividing). Add Level says so when the next level wouldn't fit.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Start from a light mesh. A cube of 108 triangles divided five times is a smooth 110,000-triangle head-sized blob; a 25,000-triangle base divided four times is already 6.5 million.</p></aside>
<h2 id="stepping-between-levels">Stepping between levels<a class="anchor" href="#stepping-between-levels" aria-label="Link to this section">#</a></h2>
<p>Press <kbd>Shift</kbd>+<kbd>D</kbd> to step down and <kbd>D</kbd> to step up, or drag the <strong>Level</strong> slider. Each step is instant once you have visited a level; the first visit after a big edit lower down takes a moment on millions of triangles.</p>
<p>What happens to your sculpting when you change level:</p>
<ul>
<li>
<strong>Detail survives.</strong> Each level stores its detail as a small offset from the smoothed shape of the level below, measured along that surface (its normal and tangents). Stepping up and down without sculpting gives back exactly the same mesh.
</li>
<li>
<strong>Big changes low, detail follows.</strong> Sculpt, move or inflate at a low level and step up: the higher levels follow the new shape and the wrinkles, pores and scales you sculpted on them ride along on top.
</li>
<li>
<strong>Detail edits show up below.</strong> Sculpt at a high level and step down: the lower levels take on a softened version of the change, so the silhouette stays honest whichever level you look at. Fine detail is too small for a low level and only shows as a gentle swelling there.
</li>
</ul>
<h2 id="what-follows-the-levels">What follows the levels<a class="anchor" href="#what-follows-the-levels" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th></th><th>When you change it at one level</th></tr></thead><tbody><tr><td>Shape</td><td>Carried up as detail, softened down (see above)</td></tr><tr><td>Sculpt layers</td><td>Each layer has its own detail on every level, kept relative to the surface like the shape's: rotate or reshape a low level and a layer's wrinkles turn and bend with it. Weights apply to all levels. See <a href="layers.html#layers-and-subdivision-levels">Layers and subdivision levels</a></td></tr><tr><td>Mask</td><td>Copied down to the vertices below, interpolated up where it changed</td></tr><tr><td>Vertex Paint and paint layers</td><td>As the mask: paint at a low level for broad colour, at a high level for detail. Painting low only changes the higher levels where you painted</td></tr><tr><td>Face Groups, hidden faces</td><td>Copied down to the parent faces, inherited up by the faces they contain</td></tr><tr><td>UVs</td><td>Copied down and interpolated up</td></tr><tr><td>Texture</td><td>Shared by every level (it lives on the UVs)</td></tr></tbody></table></div>
<p>Clearing the mask, removing a layer or deleting the paint layers does it on every level.</p>
<h2 id="remove-below-and-remove-above">Remove Below and Remove Above<a class="anchor" href="#remove-below-and-remove-above" aria-label="Link to this section">#</a></h2>
<p><strong>Remove Below</strong> deletes the levels below the current one: the current level becomes the new base cage (Level 1). <strong>Remove Above</strong> deletes the levels above, and the detail sculpted on them. Both are undoable. Deleting down to a single level leaves an ordinary mesh.</p>
<h2 id="rebuild-lower-levels">Rebuild Lower Levels<a class="anchor" href="#rebuild-lower-levels" aria-label="Link to this section">#</a></h2>
<p>A model that was subdivided in another application (or exported from SculptForge at its top level) comes in as one dense mesh. <strong>Rebuild Lower Levels</strong> finds the mesh it was subdivided from and adds it as a new lowest level, keeping the dense mesh exactly as it was. Press it again for more levels.</p>
<ul>
<li>
It works at the lowest level (Level 1).
</li>
<li>
The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision, or all triangles from Loop subdivision. Otherwise it says so and leaves the mesh alone.
</li>
<li>
The vertices of the new lower level sit on the dense mesh's corner vertices.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> The <strong>Cube</strong> from <strong>Tool > Parts > Append</strong> is a regular quad grid, so Rebuild Lower Levels takes it down to a 3 x 3 cube in four steps.</p></aside>
<h2 id="undo-projects-and-exporting">Undo, projects and exporting<a class="anchor" href="#undo-projects-and-exporting" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Undo</strong> (<kbd>Ctrl</kbd>+<kbd>Z</kbd>) is one step per stroke at any level, and one step per level change, so undo walks back through your strokes and level changes in the order you made them. Add Level, Remove Below, Remove Above and Rebuild Lower Levels are single undo steps. Steps share the levels they didn't change, so they cost little memory.
</li>
<li>
<strong>Projects</strong> (<code>.sfproj</code>) save every level of every Part and open at the level you saved at. They use project format 5 (sculpt-layer detail relative to the surface), so older SculptForge versions ask you to update before opening them. Projects saved with format 4 open as before and are converted as they load.
</li>
<li>
<strong>Exports and Bridge</strong> write the current level. To write another one, step to it first, or use the <code>subdiv_export</code> command (<code>subdiv_export path=base.obj level=1</code> writes the base cage of every visible Part, in any export format). LODs and <strong>Send to Unreal</strong> start from the current level too.
</li>
<li>
<strong>Tools that rebuild the mesh</strong> (Voxel Remesh, Decimate, Quad Remesh, Subdivide, Remove Hidden, merging and splitting Parts) work on the level you are on, including what you just sculpted there, and make a new mesh without levels: that level becomes the new base. The status line says so, e.g. <em>Subdivision levels removed: Level 3 of 5 kept as the new base (undo restores them)</em>. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings every level back, at the level you were on. Merging and splitting Parts can't be undone, so step to the level you want to keep first, or save before.
</li>
</ul>
<aside class="callout callout-note"><p><strong>Note:</strong> <strong>Subdivide (removes levels)</strong> (in <strong>Tool > Geometry</strong>, under <strong>Resolution (no levels)</strong>, apart from Add Level and Micro) replaces the mesh with a denser one and keeps no levels. On a Part with levels it asks first ("This removes your N subdivision levels"); <strong>Don't ask again</strong> turns that off. <strong>Remove Below</strong> and <strong>Remove Above</strong> ask too. Use <strong>Add Level</strong> unless you want exactly that.</p></aside>
<h2 id="commands">Commands<a class="anchor" href="#commands" aria-label="Link to this section">#</a></h2>
<p>Every control is a command you can run in the console, from a script or over MCP (see <a href="scripting.html">Scripting</a>):</p>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>subdiv_divide smooth=true</code></td><td>Add Level; <code>smooth=false</code> divides flat (Smooth off)</td></tr><tr><td><code>subdiv_level level=2</code></td><td>Step to a level (1 = base)</td></tr><tr><td><code>subdiv_lower</code>, <code>subdiv_higher</code></td><td>Lower Level, Higher Level</td></tr><tr><td><code>subdiv_delete_lower</code>, <code>subdiv_delete_higher</code></td><td>Remove Below, Remove Above</td></tr><tr><td><code>subdiv_reconstruct</code></td><td>Rebuild Lower Levels</td></tr><tr><td><code>subdiv_info</code></td><td>List the levels and their triangle counts</td></tr><tr><td><code>subdiv_export path=base.obj level=1</code></td><td>Export the visible Parts at a level</td></tr></tbody></table></div>
<h2 id="speed-and-memory">Speed and memory<a class="anchor" href="#speed-and-memory" aria-label="Link to this section">#</a></h2>
<p>Measured on an Apple M1 Pro (Asahi Linux), a cube divided four times to 6.5 million triangles:</p>
<div class="table-wrap"><table><thead><tr><th></th><th>1.6M triangles at the top</th><th>6.5M triangles at the top</th></tr></thead><tbody><tr><td>Add Level to the top</td><td>0.4 s</td><td>4.3 s</td></tr><tr><td>Step down / up between visited levels</td><td>1-4 ms</td><td>0.1-45 ms</td></tr><tr><td>Step down right after sculpting the top</td><td>0.05-0.13 s</td><td>0.2-0.6 s</td></tr><tr><td>Step up after reshaping the base</td><td>0.05-0.15 s</td><td>0.6 s</td></tr><tr><td>Memory for all levels</td><td>120 MB</td><td>480 MB</td></tr></tbody></table></div>
<p>SculptForge keeps the two levels you visited last ready to show, so going back and forth between a low and a high level (the usual rhythm) is instant. Only the active Part keeps them: selecting another Part frees that memory (50-170 MB for a Part with 1.8 million triangles at the top), and the first level change after you come back takes a moment longer (about 0.1 s at that size) while the level is prepared again.</p>
<h2 id="past-the-highest-level">Past the highest level<a class="anchor" href="#past-the-highest-level" aria-label="Link to this section">#</a></h2>
<p>For more detail than the computer can hold as a mesh (hundreds of millions of polygons), add a micro level on top of the highest level: see <a href="micro-levels.html">Micro levels</a>.</p>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="facial-shapes.html"><span>Previous</span>Facial shapes and live face</a><a class="next" rel="next" href="micro-levels.html"><span>Next</span>Micro levels: hundreds of millions of polygons</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help > User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/subdivision-levels.md">Edit this page on GitHub</a>.</p>
</main>
<aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#add-level">Add Level</a></li><li><a href="#stepping-between-levels">Stepping between levels</a></li><li><a href="#what-follows-the-levels">What follows the levels</a></li><li><a href="#remove-below-and-remove-above">Remove Below and Remove Above</a></li><li><a href="#rebuild-lower-levels">Rebuild Lower Levels</a></li><li><a href="#undo-projects-and-exporting">Undo, projects and exporting</a></li><li><a href="#commands">Commands</a></li><li><a href="#speed-and-memory">Speed and memory</a></li><li><a href="#past-the-highest-level">Past the highest level</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
<div>
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
<p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
</div>
<div class="links">
<a href="../performance/">Performance</a>
<a href="index.html">User guide</a>
<a href="../supporters.html">Members</a>
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services & privacy</a>
</div>
<p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
</html>