"use server"
"use server" is the directive string recognized by the server function compiler.
Import
No import is required for the directive.
Type
const DIRECTIVE = "use server";Parameters
The directive has no parameters.
Return value
The directive does not return a value.
Behavior
- The compiler uses
"use server"as its directive string. - Client builds transform server references with the configured client runtime.
- SSR and server-function builds use the configured server runtime for transformed references.
- Valid transformed modules are added to the server function manifest.
Examples
Function directive
const logMessage = async (message: string) => { "use server"; console.log(message);};File directive
"use server";
export async function logMessage(message: string) { console.log(message);}Using with query
When wrapping a server function with query, place "use server" inside the inner function rather than at the file level. A file-level directive turns the whole module — including the query wrapper that also runs on the client — into a server reference.
export const logMessage = query(async (message: string) => { "use server"; console.log(message);}, "log-message");