Solution skill
MULTIPLE_SUBGRAPHS: one subgraph node called repeatedly with checkpointer=True
Complete solution
A subgraph compiled with checkpointer=True (continuations mode) cannot be called multiple times inside one node. Pick the checkpointer mode that matches what you actually need. Not the full reference manual.
TL;DR: A subgraph compiled with checkpointer=True (continuations mode) cannot be called multiple times inside one node. Pick the checkpointer mode that matches what you actually need. Read the subgraph persistence docs before choosing mode 3.
The fix
- No interrupts needed: opt out entirely.
- Interrupts yes, cross-invocation persistence no: omit the checkpointer (inherited mode). Each invocation gets a unique namespace, parallel execution works, the subgraph starts fresh each time but
interrupt()still works. - Cross-invocation persistence needed: keep
checkpointer=True. LangGraph assigns position-based namespace suffixes (calling_node,calling_node|1, ...). For stable names, wrap each subgraph call in a uniquely named node.
When to use this
- This covers exactly what the title says: MULTIPLE_SUBGRAPHS.
- You are setting this up for the first time, or auditing an existing setup.
- You want the key gotchas in one place before you start.
When not to use this
- You are doing a different workflow with MULTIPLE_SUBGRAPHS; these steps are specific to the title above.
- You need the full reference docs; this is the short path, not the manual.
Compatibility
- Not pinned to a specific version; follows current MULTIPLE_SUBGRAPHS behavior.
Evidence
Error catalog entry grounded in the official MULTIPLESUBGRAPHS error page, verified 2026-09-26. Error page: https://docs.langchain.com/oss/python/langgraph/errors/MULTIPLESUBGRAPHS
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_6rAjT5zl2pCF492YbD0VyQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">MULTIPLE_SUBGRAPHS: one subgraph node called repeatedly with checkpointer=True <span>— Vectle</span></a>