Sync kit docs (#1509)

github-actions[bot] · svelte-docs-bot[bot] · web-flow · commit 17212cc464d8 · 2025-08-27T13:38:59.000-07:00
sync kit docs

Co-authored-by: svelte-docs-bot[bot] &lt;196124396+svelte-docs-bot[bot]@users.noreply.github.com&gt;
diff --git a/apps/svelte.dev/content/docs/kit/20-core-concepts/60-remote-functions.md b/apps/svelte.dev/content/docs/kit/20-core-concepts/60-remote-functions.md
@@ -161,17 +161,40 @@ export const getPost = query(v.string(), async (slug) => {
 
 Both the argument and the return value are serialized with [devalue](https://github.com/sveltejs/devalue), which handles types like `Date` and `Map` (and custom types defined in your [transport hook](hooks#Universal-hooks-transport)) in addition to JSON.
 
-### Refreshing queries
+### Updating queries
 
-Any query can be updated via its `refresh` method:
+Any query can be re-fetched via its `refresh` method, which retrieves the latest value from the server:
 
 ```svelte
 <button onclick={() => getPosts().refresh()}>
 	Check for new posts
 </button>
 ```
 
-> [!NOTE] Queries are cached while they're on the page, meaning `getPosts() === getPosts()`. This means you don't need a reference like `const posts = getPosts()` in order to refresh the query.
+Alternatively, if you need to update its value manually, you can use the `set` method:
+
+```svelte
+<script>
+	import { getPosts } from './data.remote';
+	import { onMount } from 'svelte';
+
+	onMount(() => {
+		const ws = new WebSocket('/ws');
+		ws.addEventListener('message', (ev) => {
+			const message = JSON.parse(ev.data);
+			if (message.type === 'new-post') {
+				getPosts().set([
+					message.post,
+					...getPosts().current,
+				]);
+			}
+		});
+		return () => ws.close();
+	});
+</script>
+```
+
+> [!NOTE] Queries are cached while they're on the page, meaning `getPosts() === getPosts()`. This means you don't need a reference like `const posts = getPosts()` in order to update the query.
 
 ## form
 
diff --git a/apps/svelte.dev/content/docs/kit/98-reference/10-@sveltejs-kit.md b/apps/svelte.dev/content/docs/kit/98-reference/10-@sveltejs-kit.md
@@ -2191,6 +2191,12 @@ type RemotePrerenderFunction<Input, Output> = (
 
 ```dts
 type RemoteQuery<T> = RemoteResource<T> & {
+	/**
+	 * On the client, this function will update the value of the query without re-fetching it.
+	 *
+	 * On the server, this throws an error.
+	 */
+	set(value: T): void;
 	/**
 	 * On the client, this function will re-fetch the query from the server.
 	 *
