If you’re working with Faceit in Blender to animate characters, eye blinking is a small detail that makes models look real. But sometimes, the eye blinking just doesn’t work. This can be confusing, especially for beginners or those new to Blender’s Faceit add-on. This guide will help you understand why this happens and how to fix it, using simple steps and real examples.
Understanding Faceit And Eye Blinking
Faceit is a popular Blender add-on for facial rigging. It helps automate the process of creating facial expressions, including eye blinks. Eye blinking usually works by controlling shape keys or bones that move the eyelids. If eye blinking stops working, it can ruin the realism of your animation.
Many users run into this problem after importing new models, updating blender, or using different rigs. It’s important to know the basics of how Faceit handles blinking to troubleshoot issues.
Common Reasons Eye Blinking Fails
Several things can cause the eye blink function to break. Here are the most frequent causes:
- Missing shape keys: The model doesn’t have the right shape keys for blinking.
- Shape key names changed: Faceit expects certain names, and renamed keys break the function.
- Wrong rig type: Some rigs are not compatible with Faceit’s auto-setup.
- Drivers disconnected: Animation drivers that control the eyelids are broken or missing.
- Pose Library issues: If the pose library is corrupted or missing, blinks won’t play.
- Export/import errors: Models from other software may lose blink data.
Let’s look at how to find and fix each problem.

Credit: superhivemarket.com
How To Diagnose And Fix Blinking Problems
1. Check For Shape Keys
Eye blinking in Faceit usually uses shape keys like Blink_Left and Blink_Right. If these are missing, blinking will not work.
- In Blender, select your mesh and go to the Data Properties panel.
- Look under Shape Keys. You should see keys named something like “Blink_L” and “Blink_R”.
If they are missing, you need to create them. You can sculpt the eyelids closed and add new shape keys, or use Faceit’s auto-generate tool.
2. Correct Shape Key Naming
Faceit expects certain names for shape keys. If you renamed them, blinking fails.
- Compare your shape key names with Faceit’s documentation.
- Rename any incorrect keys to match Faceit’s standards (for example, “Blink_L” or “Blink_Left”).
This small fix solves the problem for many users.
3. Reconnect Animation Drivers
Drivers link controller bones to shape keys. Sometimes these links break.
- Right-click on a shape key’s value and select Edit Driver.
- Make sure the driver points to the correct bone or control.
If drivers are missing, you’ll need to re-add them. This step is tricky for beginners, but many tutorials show how to set up drivers for eyelid movement.
4. Confirm Rig Compatibility
Not every rig works with Faceit out of the box. Standard rigs like Rigify are most compatible.
Here’s a quick comparison:
| Rig Type | Faceit Compatibility | Notes |
|---|---|---|
| Rigify | High | Works well with Faceit |
| Mixamo | Medium | May need manual fixes |
| Custom Rigs | Low | Often need full manual setup |
If you’re using a custom or imported rig, you may have to set up blinks yourself.
5. Inspect The Pose Library
The Pose Library stores facial poses, including blinks. If it’s missing or corrupted, blinks won’t play.
- Open the Pose Library in Blender.
- Look for pose entries like “Blink Left” and “Blink Right”.
If these are missing, you can re-add them:
- Select the eyelid controller.
- Pose the eyelids closed.
- Add a new pose to the library.
6. Export And Import Settings
Some file formats lose shape key or driver data during export/import. FBX and OBJ often cause problems.
Here’s a basic comparison:
| File Format | Shape Key Support | Driver Support |
|---|---|---|
| .blend | Yes | Yes |
| .fbx | Partial | No |
| .obj | No | No |
Always keep your work in the native .blend format as long as possible.
Advanced Troubleshooting Tips
- Check Blender version: Sometimes, add-ons like Faceit need updates after Blender changes.
- Reinstall Faceit: If nothing works, uninstall and reinstall the add-on.
- Look for script errors: Open Blender’s system console and watch for red error messages when you try to blink.
- Reset user preferences: Sometimes, resetting preferences fixes strange Faceit behavior.
A common insight: some users forget that importing a rig from another project can overwrite shape keys or drivers. Always check your model after import.
Another tip: animating eye blinks manually is sometimes easier than fixing a broken auto-blink. If you’re on a deadline, try keyframing the eyelid shape keys directly.

Credit: blog.gfxplugin.com
Practical Example: Fixing A Non-working Eye Blink
Suppose your character’s right eye won’t blink. Here’s what you should do:
- Select the head mesh and check for a “Blink_R” shape key.
- If missing, add a new shape key and sculpt the eyelid closed.
- Rename it “Blink_R”.
- Add a driver to the shape key and link it to the eyelid control bone.
- Test the control bone—if the eyelid moves, you’ve fixed it.
If it still doesn’t work, check the Faceit add-on panel for errors, and try re-running the Faceit setup process.
When To Ask For Help
Sometimes, no matter what you try, Faceit’s blinking still fails. In these cases:
- Ask in Blender forums or Faceit’s official Discord.
- Include screenshots of your shape keys and rig.
- Share your Blender version and Faceit version.
Many users find help from the community, especially if they show what they’ve already tried. For more technical details, you can check the official Blender documentation.

Credit: blog.gfxplugin.com
Frequently Asked Questions
Why Does Eye Blinking Stop Working After Importing A Model?
Most likely, shape keys or drivers did not import correctly. Some formats lose these connections. Always check your shape keys and drivers after importing.
Can I Use Faceit With Any Rig?
Faceit works best with standard rigs like Rigify. Custom rigs may need manual setup for blinking and other facial controls.
What Shape Key Names Does Faceit Use For Blinking?
Faceit usually looks for shape keys named Blink_L (or Blink_Left) and Blink_R (or Blink_Right). Names must match or the add-on won’t find them.
How Do I Add A Missing Blink Shape Key?
Select your mesh, add a new shape key, sculpt the eyelid closed, and rename it to match Faceit’s expected name. Link it to the correct controller with a driver.
Is There A Way To Animate Blinks Without Faceit?
Yes. You can keyframe the eyelid shape keys or bones directly in Blender. This is a reliable fallback if Faceit has issues.
Solving Faceit Blender eye blinking not working can be frustrating, but most problems have clear solutions. Check shape keys, drivers, and rig compatibility. With these steps, your character’s eyes will blink naturally and your animations will look more lifelike.

Dorothy Addeo is a senior product reviewer at Safefins.com with years of experience testing kitchen, furniture, backpacks, and everyday lifestyle products. She focuses on comfort, durability, usability, and long-term value through hands-on research and real-world testing. Her goal is to help readers find reliable products with honest, easy-to-understand recommendations they can trust.