From 1c272bf180ec2a91666c5a905dc925435ff5a1f9 Mon Sep 17 00:00:00 2001 From: Gregor Becker Date: Mon, 20 Jul 2026 19:15:04 +0200 Subject: [PATCH] docs: explain purpose and use case of load() closes #1753 --- docs/content/2.api/3.query/load.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/content/2.api/3.query/load.md b/docs/content/2.api/3.query/load.md index 8f4b6c7f2..cdf3bde3f 100644 --- a/docs/content/2.api/3.query/load.md +++ b/docs/content/2.api/3.query/load.md @@ -5,6 +5,8 @@ description: 'Eager load relations on the model.' # `load()` +Attaches relations to models that were **already retrieved** from the store. Use it when you fetched a collection without `with()` — e.g. because the relations weren't needed at that point, or the data comes from a cached query — and you want to add relations afterwards without re-running the whole query. This is the lazy-loading counterpart to eager loading with [`with()`](with). + ## Usage ````ts