diff --git a/docs/content/4.api/1.components/2.content-list.md b/docs/content/4.api/1.components/2.content-list.md
index 6787365c8..cb8a6f8e8 100644
--- a/docs/content/4.api/1.components/2.content-list.md
+++ b/docs/content/4.api/1.components/2.content-list.md
@@ -13,7 +13,7 @@ An explicit `path`{lang=ts} can be given to the component.
 - `path`{lang=ts}: The path of the content to load from content source.
   - Type: `String`{lang=ts}
   - Default: `'/'`{lang=ts}
-- `query`{lang=ts}: A query to be passed to `queryContent()`.
+- `query`{lang=ts}: A query builder params object to be passed to `<ContentQuery />` component.
   - Type: `QueryBuilderParams`{lang=ts}
   - Default: `undefined`{lang=ts}
 
@@ -48,3 +48,23 @@ An explicit `path`{lang=ts} can be given to the component.
   </main>
 </template>
 ```
+
+## Query example
+
+```html [pages/index.vue]
+<script setup lang="ts">
+import type { QueryBuilderParams } from '@nuxt/content/dist/runtime/types'
+const query: QueryBuilderParams = { path: '/articles', where: { layout: 'article' }, limit: 5, sort: { date: -1 } }
+</script>
+
+<template>
+  <main>
+    <ContentList :query="query" v-slot="{ list }">
+      <div v-for="article in list" :key="article._path">
+        <h2>{{ article.title }}</h2>
+        <p>{{ article.description }}</p>
+      </div>
+    </ContentList>
+  </main>
+</template>
+```