Reference only

Value not in list: why a downloaded model does not appear in ComfyUI

A saved ckpt_name, lora_name or another selection is absent from the current allowed list. Check the input name first: this validation error can also concern non-file options such as samplers.

Symptoms and scope

A saved ckpt_name, lora_name or another selection is absent from the current allowed list. Check the input name first: this validation error can also concern non-file options such as samplers.

Error fragments for search; IDs, values and filenames may vary:

Value not in list
ckpt_name

Source-supported context

Official model troubleshooting shows Value not in list when a saved checkpoint choice is absent from the current options. The failing field may instead be a non-file selection, so read its allowed values before changing model files. Absence from a list does not prove absence from every server disk. Source 1 Source 2

Cases to distinguish

1. The workflow stores another machine's relative filename, subdirectory or old name.

2. The file belongs to another instance or category, or is only an incomplete download or saved webpage.

3. An updated core/node changed the permitted options, and the field may not represent a model file at all.

Diagnostic sequence

The sequence below is an editorial procedure based on the cited context, not a diagnosis already confirmed for your environment.

Step 1. Read the failing input name and allowed values in the error details. Distinguish a resource selector from an enumeration parameter.

Step 2. Locate the running instance's model root and extra_model_paths configuration. Check the category and subdirectory spelling.

Step 3. Select an option that actually exists through the interface and refresh/restart scanning using the supported method. Editing JSON to name a nonexistent file is not a repair.

Step 4. For an empty list, investigate scanning paths and read permissions. For one missing file, check extension, completeness and loader support before testing execution.

Completion check

The real file or option appears in the selector and passes validation. Successful loading is a further check of file readability.

Limitations and cautions

A similarly named model may introduce shape errors. Renaming a file neither changes its model family nor repairs corrupt contents.

Original sources

Localization prepared: 2026-09-22. The source-check dates above were inherited from the existing article; this translation does not claim they were all rechecked today. No GPU run, minimum-memory measurement or runtime guarantee is supplied.

Didn't solve it?

Check the next possible cause

The same symptom can come from a different cause. Work through these related entries in order.

  1. Safetensors header errors: verify the artifact before changing loadersHeaderTooLargeA .safetensors header parsing failure can involve an incomplete or wrong download, a different format or a parser/loader mismatch. The message alone does not uniquely prove corruption.
Paste your full log into the error finder

Was this page helpful?

Anonymous. Only a yes/no counter is stored; no account, IP address or device details.

Sources & references

Localized from the existing Chinese research draft. Original source-check dates are retained; this translation is not new technical verification or a runtime test.

01ComfyUI model troubleshootingSource checked: 2026-09-2102ComfyUI Portable WindowsSource checked: 2026-09-21

Report an issue · 2e8baa27-1f68-57d0-957e-bfc7c13d01ea