How to Enable Face Restoration in Automatic1111 and ComfyUI
Tutorial

How to Enable Face Restoration in Automatic1111 and ComfyUI

Step-by-step guide to enabling GFPGAN and CodeFormer face restoration in Automatic1111, Forge, and ComfyUI — plus fixes for 'models not found' and 'unable to load face restoration model' errors.

GFPGAN Team | June 10, 2026

Stable Diffusion faces are often close, but not quite right — slightly asymmetric eyes, soft detail, or a subtle uncanny-valley quality. Both Automatic1111 and ComfyUI ship with face restoration built in or available as an extension. This guide covers exactly how to enable it in each, plus the specific errors people run into.

Face Restoration in Automatic1111 (and Forge)

Automatic1111 WebUI bundles GFPGAN by default and supports CodeFormer as an alternative. Both live under the generation settings.

  1. Enable the checkbox. In the txt2img or img2img tab, expand the settings below the prompt box and check “Restore faces.” This runs face restoration automatically on every generated image.
  2. Choose the model. Go to Settings → Face restoration. Pick GFPGAN (faster, better on heavily degraded or stylized faces) or CodeFormer (better identity fidelity on realistic portraits) as the default model.
  3. Set CodeFormer’s fidelity weight (if selected) — a value between 0 and 1. Lower values lean toward the AI’s reconstruction; higher values stay closer to the original generated face. 0.5 is a reasonable starting point.
  4. Forge UI uses the same settings location and behavior as Automatic1111 — “Restore faces” checkbox plus the same Settings → Face restoration panel, since Forge is a fork of the same codebase.

If you don’t see the “Restore faces” checkbox, it may be hidden under Settings → User interface → Quick settings list — add face_restoration there, or check the Actions column visibility in newer WebUI versions.

Face Restoration in ComfyUI

ComfyUI doesn’t bundle face restoration by default — it uses a node-based workflow, so you add a dedicated face restoration node:

  1. Install the ComfyUI-Impact-Pack or a dedicated face-restoration node pack (such as comfyui-reactor or facerestore nodes) through the ComfyUI Manager.
  2. Download the GFPGAN or CodeFormer model weights and place them in the correct folder — typically ComfyUI/models/facerestore_models/ (exact folder name depends on which node pack you installed; check the node’s README).
  3. Add the face restoration node to your workflow graph, usually placed after your KSampler/VAE Decode output and before any final upscale node.
  4. Connect the image output from your generation pipeline into the face restoration node’s input, then run the workflow.

Fixing “Face Restoration Models Not Found”

This is the most common error, and it almost always comes down to file placement:

  • Check the exact folder. Automatic1111 expects GFPGAN weights in stable-diffusion-webui/models/GFPGAN/ and CodeFormer weights in stable-diffusion-webui/models/Codeformer/. ComfyUI face-restoration node packs typically expect ComfyUI/models/facerestore_models/ — but always confirm against the specific node pack’s documentation, since this varies by extension.
  • Check the filename. Some installs expect an exact filename match (e.g. GFPGANv1.4.pth) rather than any .pth file in the folder.
  • Restart after adding the file. Both WebUI and ComfyUI scan model folders at startup — dropping a new file in mid-session usually requires a restart or a manual “refresh” of the model list.
  • Re-download if the file is corrupted. A partial or interrupted download produces a file that exists but fails to load — delete and re-download from the model’s official source.

Fixing “Unable to Load Face Restoration Model”

If the file is present but still won’t load:

  • Confirm the .pth file size matches the official release (a truncated download is the most common cause).
  • Check that your PyTorch/CUDA version is compatible with the WebUI or ComfyUI version you’re running — very old or very new installs occasionally break compatibility with older model checkpoints.
  • Check the console/terminal output for the specific exception — a RuntimeError mentioning key mismatches usually means the file is the wrong model version for the code expecting it (e.g. a v1.2 checkpoint loaded by code expecting v1.4’s architecture).

Fixing “Stable Diffusion Face Restoration Missing” After an Update

WebUI updates occasionally reset or relocate the models/GFPGAN and models/Codeformer folders. If face restoration options disappear after an update:

  1. Confirm the folders still exist at the expected path — reinstalls sometimes create fresh, empty model directories.
  2. Re-copy your model weights back into place.
  3. Check Settings → Face restoration to confirm the model dropdown is populated again.

Frequently Asked Questions

Does Automatic1111 use GFPGAN or CodeFormer by default?

Automatic1111 ships with GFPGAN as the default face restoration model, but CodeFormer is available as a built-in alternative — switch between them under Settings → Face restoration.

Why does ComfyUI not have face restoration built in?

ComfyUI is node-based and intentionally minimal by default — face restoration is added through community node packs (like ComfyUI-Impact-Pack or dedicated facerestore nodes) rather than being bundled, so users only install what their workflow needs.

Where do I put GFPGAN model files in Automatic1111?

Place the .pth weights file in stable-diffusion-webui/models/GFPGAN/. Restart the WebUI (or use the refresh button next to the model dropdown) so it picks up the new file.

Can I skip local setup and just restore a face online?

Yes — if you don’t want to install or configure anything locally, the browser-native GFPGAN tool on this site restores photos directly with no setup, upload, or account required.