MULTIPLE_SUBGRAPHS

​

Troubleshooting

1. Don’t need interrupts? Use checkpointer: false to opt out of checkpointing entirely:
   Copy

   const subgraph = subgraphBuilder.compile({ checkpointer: false });
   
2. Need interrupts but not cross-invocation persistence? Use the default inherited mode by omitting checkpointer:
   Copy

   const subgraph = subgraphBuilder.compile();
   
   Each invocation gets a unique namespace, so parallel execution works. The subgraph starts fresh each time but can use interrupt().
3. Need cross-invocation persistence? Use checkpointer: true. LangGraph assigns each invocation a position-based namespace suffix (calling_node, calling_node|1, etc.) to prevent conflicts. For stable, name-based namespaces, wrap each subgraph with a unique node name — see parallel subgraphs.

​

Related

• Subgraph persistence — full comparison of checkpointer modes
• Persistence — how checkpointers work in LangGraph