Object Matte not working in After Effects? Causes and fixes
Object Matte missing, slow, losing the subject or chattering? A symptom-to-fix table, a clean workflow and the checks Adobe documents, as of AE 26.5.
When Object Matte “doesn’t work,” it’s usually one of four things. The clip is open in the wrong panel, one propagation is being asked to cover too much of the shot, the subject gets hidden or blends into the background, or the machine runs short of memory or cache. Object Matte is After Effects’ AI rotoscoping tool: you select a subject on one frame, and After Effects carries that selection through the shot as a matte. It replaced Roto Brush in After Effects 26.2 (April 2026); as of September 2026 the current release is 26.5. The fixes are mostly workflow: trim the range, split the shot where the subject is hidden, fix the frame where the matte drifts, refine edges only where you need them, and freeze.
Below: what changed from Roto Brush, a symptom-to-fix table, a workflow for hard shots, the hardware checks Adobe documents, why AI mattes struggle, and when to switch tools. If you’re choosing between Object Matte, Magic Mask and Premiere’s Object Mask, see our comparison; this post is about getting Object Matte itself to behave.
Did Object Matte replace Roto Brush?
Yes. In After Effects 26.2, Object Matte took Roto Brush’s place in the toolbar. A member of Adobe’s After Effects engineering team confirmed it on the Adobe Community forum: “In AE 26.2, Roto Brush has been replaced by the Object Matte tool.” The old tool isn’t completely gone. Adobe describes classic Roto Brush as “reimagined” as the Quick Selection tool, and in the same thread an Adobe community manager said you can still choose between Roto Brush and Object Matte versions in the Effect Controls panel once Object Matte is applied.
As of September 2026, Adobe’s Object Matte page lists four tools:
- Object Matte tool: selects a subject with one click, or with a Rectangle or Lasso marquee.
- Quick Selection: click or drag to select an object “based on its color, contrast, and edges.”
- Selection Brush: additive and subtractive strokes for corrections.
- Refine Edge: paint along edges to keep natural detail such as hair.
The basic flow: open the layer in the Layer panel, select the subject on a base frame, then move forward through the timeline (play, step frame by frame or drag the time indicator). After Effects propagates the matte as you go, and green segments on the timeline mark the frames that are done. When you’re satisfied, you select Freeze at the bottom of the Layer panel to lock the matte.
Two later releases matter for troubleshooting. Per Adobe’s fixed issues list, 26.2.1 fixed an Object Matte launch crash and a bug where aerender failed to render comps containing Object Matte. And 26.5 (September 2026) added disk caching. Before it, Adobe says, propagated frames lived only in memory and were lost if you closed without freezing or ran low on RAM.
Object Matte problems: symptom, cause and fix
Most problems come from a handful of causes. Find the symptom you’re seeing.
| Symptom | Likely cause | Fix |
|---|---|---|
| Tool or its icons don’t appear | Clip open in the Footage panel, not the Layer panel | Open it in the Layer panel; check the double-click preference |
| Not in Effects & Presets or Help search | It’s a tool that applies an effect, not an effect you drag on | Start from the Object Matte tool in the toolbar |
| Propagation crawls or stalls | Long range, heavy source files, low RAM, slow cache drive | Trim the range, work in sections, check RAM and storage |
| Propagated frames gone after reopening | Before 26.5, frames were held only in memory | Update to 26.5, or freeze before closing |
| Crashes with disk cache on (26.0, 26.2) | Known issue with Compressed Disk Caching | Update, or turn off compressed frames (see below) |
| Matte jumps to a nearby object | Similar color and contrast; nothing clear to separate on | Subtract with Selection Brush on that frame; add a garbage matte |
| Matte loses the subject after something passes in front | The subject disappears and comes back | Split the shot at the occlusion; reselect on the first clean frame |
| Edges chatter or look hard on hair and blur | Edge decided per frame, in or out, with no partial alpha | Refine Edge on the soft edges only; hand roto the worst frames |
Why isn’t the Object Matte tool showing up?
Almost always because you’re in the Footage panel. Object Matte, like Roto Brush before it, only works in the Layer panel. An Adobe employee answered this question directly on the Adobe Community forum: “You’re in the footage panel not the layer panel which is where Object Matte and Rotobrush function.” The same answer suggests your preferences may be set to open the Footage panel on double-click. In Adobe’s preferences documentation, that setting is On Footage Layer Opens, in the Opening Layers with Double-click section of the Composition preferences.
Two other reasons it can seem to be missing:
- It isn’t in the Effects list. An After Effects quality engineer explained that Object Matte “needs a selection from the Object Matte tool to initialize,” so searching Effects & Presets or the macOS Help menu won’t find it. Start from the tool.
- You’re on an older version. Object Matte shipped in 26.2. On 25.x you still have Roto Brush.
Failing that, Adobe documents a full preferences reset: hold Ctrl+Alt+Shift (Windows) or Command+Option+Shift (macOS) while After Effects starts. Note your custom settings first.
How do you get a clean Object Matte on a hard shot?
Give each propagation less to do, and fix it where it goes wrong rather than everywhere. On a difficult shot, this order works:
- Trim to what you need. Cut the layer to the edit plus handles. Every propagated frame costs time and cache.
- Match the frame rate and stay at Full resolution. Adobe’s Roto Brush documentation, which still covers the older versions, says to work in a comp whose frame rate matches the source and to keep resolution at Full, because switching resolution forces the segmentation to recalculate. Adobe doesn’t document a proxy workflow for Object Matte, so save time by working on fewer frames, not smaller ones.
- Start on a good frame. Make the first selection where the subject is fully visible and clearly separated from the background. Adobe describes propagation as moving forward through the timeline, so if the opening frames are the hard ones, treat them as their own section.
- Split the shot at occlusions. When someone walks in front of the subject, or it leaves frame and comes back, end the section there. Duplicate the layer, trim each copy to one section, select the subject fresh on the first clean frame of each, and combine the mattes in the comp. Each propagation then only follows a subject it can see.
- Propagate in short runs and review. Step forward a second or two, stop, and look at the matte on its own over a contrasting background. Chatter shows at speed, not on single frames.
- Fix the first bad frame, not every frame. Use Selection Brush to add or subtract on the frame where the matte first drifts, then continue. Adobe notes that the individual selections and their keyframes are listed in the Timeline under the layer’s Effects > Object Matte > Selections.
- Refine only the soft edges. Use Refine Edge on hair and fur. Solid edges, like a jacket or a car body, usually hold without it.
- Freeze, then render the matte out. Freeze each section once it’s right. If the matte is going to another app or a render farm, render it to a file with alpha so the work doesn’t depend on the live effect. Our guide to alpha channels covers formats and straight vs premultiplied.
Why is Object Matte slow, and which settings help?
Adobe’s Object Matte page lists no hardware requirements of its own, so as of September 2026 the general After Effects requirements and performance advice are what apply.
- Update After Effects. Use 26.5 or later for disk caching, and at least 26.2.1 for the crash and aerender fixes. Adobe’s performance guide recommends the current version and updates (Help > Updates).
- Update the GPU driver. The same guide says to install the latest drivers, “especially video card drivers,” and Adobe’s GPU page recommends NVIDIA’s latest Studio driver. Adobe doesn’t say whether Object Matte uses the GPU, so this is upkeep, not a promised speedup.
- RAM. Adobe’s system requirements list 16 GB as the minimum and recommend 32 GB or more for 4K and higher. The performance guide suggests at least 2 GB per processor core, and closing other apps so the system doesn’t swap memory to disk.
- GPU memory. Minimum 4 GB, recommended 8 GB.
- Fast local storage. Adobe advises keeping source footage on a fast local disk rather than network storage, and putting the disk cache on a separate fast drive, ideally an SSD.
- The compressed-cache crash. Adobe lists a known issue: 26.0 and 26.2 may crash with Compressed Disk Caching enabled, which is on by default. The workaround is Preferences > Disk > Disk Cache, then uncheck Enable Compressed Frames (Lossless). From 26.2.1, hardware found to be incompatible falls back to uncompressed caching automatically.
The source file matters too. Every frame has to be decoded before it’s analyzed, and in Adobe’s beta thread some testers reported very slow propagation on large camera-original files. For a heavy raw or long-GOP plate, a same-resolution intermediate transcode is common practice, though Adobe doesn’t document it for Object Matte.
Why do AI mattes struggle with hair, motion blur and occlusion?
Because the model has to decide which pixels belong to the subject, and in these cases the honest answer is “partly” or “it can’t see it.”
- Hair and fur. One edge pixel holds a little hair and a little background. A per-pixel in-or-out decision draws a line through it; you need partial alpha, which Refine Edge and dedicated matting tools try to add.
- Motion blur. The subject is smeared across the background, so the true edge is a gradient many pixels wide. A crisp matte inside a blurred subject looks cut out.
- Occlusion. When something passes in front, propagation has to decide whether what comes back is the same subject. When it guesses wrong, the matte drops the subject or follows the occluder.
- Similar colors. Adobe says Quick Selection works from color, contrast and edges. When subject and background share them, there’s little to separate on.
None of this is unique to Object Matte. We cover the criteria for judging any AI matte in is AI rotoscoping good enough for client work?, and why these same cases slow down hand roto in what is rotoscoping.
When should you stop fighting Object Matte?
Stop when your corrections stop converging: each fix breaks another frame, or the time you’ve spent passes what hand roto would have cost. At that point, move the shot:
- Manual roto in After Effects. Hand-drawn masks, with the Mask Tracker that Adobe updated in 26.3. It’s slow, but every edge is yours and the shapes stay editable.
- Mocha Pro (Boris FX), a planar tracker that runs as an After Effects plugin. As of September 2026, version 2026.5 lists Object Brush, which “generates editable splines with a single click,” and Matte Refine ML for soft edges (Boris FX).
- Silhouette (Boris FX), a dedicated roto and paint application that also runs as a plugin in After Effects, with Mask ML, Matte Assist ML and Matte Refine ML, and roto shape export (Boris FX).
- Magic Mask in DaVinci Resolve Studio, if the shot is going through Resolve anyway. It’s a Studio feature, and Resolve 21’s Render in Place can cache a tracked mask “as a traveling matte node” (Blackmagic Design).
- A roto artist or vendor, when the edge is the shot: hair in a beauty spot, a hero product, or a client who expects roto shapes as a deliverable.
Where nolanlabs fits
Every nolanlabs job, whether it’s cleanup, an environment change, relighting or object editing, comes back with a matte of what it touched. When the matte is the job, you point at the subject by describing it or clicking on it, and nolanlabs returns a matte that follows it through the shot. It comes back as files (a matte and an RGBA pass at the source’s resolution, frame rate and frame count) that you refine in your After Effects comp, not a live effect you keep propagating. When a job changes the world behind the actors (Environment), their matte comes back with it. The limits are real: it’s a pixel matte, not splines, and fine hair against a busy background and heavy motion blur are hard for us too. Access is by invitation; the shot Object Matte keeps losing is a good one to bring to a demo.
The practical version: open the layer in the Layer panel, run 26.5 or later, trim and split the shot, fix the first bad frame of each problem, and freeze. When the corrections stop converging, move the shot to a tool that gives you shapes, or to someone who draws them.
Questions
- Why is the Object Matte tool not showing up in After Effects?
- Usually because the clip is open in the Footage panel, and Object Matte only works in the Layer panel. An Adobe employee confirmed this on the Adobe Community forum and pointed to the double-click preference that decides which panel opens. Object Matte also doesn't appear in the Effects & Presets list, because it has to start from a selection made with the Object Matte tool, and it needs After Effects 26.2 or later.
- Where did Roto Brush go in After Effects?
- In After Effects 26.2 (April 2026), Object Matte replaced Roto Brush in the toolbar, according to Adobe's After Effects team. Adobe describes the classic Roto Brush as reimagined as Object Matte's Quick Selection tool. An Adobe community manager also said older Roto Brush versions can still be chosen in the Effect Controls panel after Object Matte is applied.
- Why is Object Matte so slow?
- It propagates and stores a matte for every frame you move through, so long ranges, heavy source files, low RAM and slow cache drives all add up. Trim the layer to the frames you need, work in short sections, keep footage and cache on fast local drives, and update to After Effects 26.5 or later. From 26.5, Adobe caches propagation results to disk, so they survive closing the project and take less RAM.
- Can Object Matte handle hair and motion blur?
- Partly. Adobe provides the Refine Edge tool for natural edges and fine detail such as hair, but fine hair against a busy background and heavy motion blur are still the hardest cases for any AI matte. On hero shots, expect to combine Object Matte with a separate edge matte, manual roto or a dedicated tool.
Sources
- AI-powered Object Matte — Adobe After Effects Help (last updated Sep 9, 2026) — accessed 2026-09-27
- What's new in After Effects — Adobe (26.2, 26.3, 26.5; last updated Sep 18, 2026) — accessed 2026-09-27
- Fixed issues in After Effects — Adobe (last updated Sep 9, 2026) — accessed 2026-09-27
- Known issues in After Effects — Adobe (last updated Sep 9, 2026) — accessed 2026-09-27
- Roto Brush and Refine Matte — Adobe After Effects Help (last updated Apr 15, 2026) — accessed 2026-09-27
- Setting preferences in After Effects — Adobe (last updated Mar 27, 2026) — accessed 2026-09-27
- After Effects system requirements — Adobe (last updated Sep 9, 2026) — accessed 2026-09-27
- GPU and GPU driver requirements for After Effects — Adobe (last updated Mar 27, 2026) — accessed 2026-09-27
- Improve performance in After Effects — Adobe (last updated Apr 17, 2026) — accessed 2026-09-27
- The Rotobrush tool is missing from my most recent update (v26.2.1) — Adobe Community, answers from the After Effects team — accessed 2026-09-27
- Object matte not available — Adobe Community, answer by an Adobe employee — accessed 2026-09-27
- Object Matte doesn't show up in the Help search — Adobe Community, answer by an After Effects Sr. Quality Engineer — accessed 2026-09-27
- New in Beta: Object Matte in After Effects — Adobe Community (February 2026) — accessed 2026-09-27
- Mocha Pro (2026.5) product page — Boris FX — accessed 2026-09-27
- Silhouette (2026) product page — Boris FX — accessed 2026-09-27
- DaVinci Resolve 21: what's new — Blackmagic Design — accessed 2026-09-27
- DaVinci Resolve Studio — Blackmagic Design — accessed 2026-09-27
Written by the nolanlabs team. nolanlabs does AI shot work for post-production; product names mentioned belong to their owners. Tool details were accurate on the date shown above — check the vendor’s documentation before relying on them.
