Open History to see the last commit
1---
2id: FormResetOptions
3title: FormResetOptions
4---
5β
6Defined in: [FormApi/FormApi.public.ts:554](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/FormApi.public.ts#L554)
7β
8Options controlling whether `reset(values)` replaces the default-value
9baseline.
10β
11## Example
12β
13```ts
14formApi.reset(savedValues, { updateDefaultValues: false })
15```
16β
17## Properties
18β
19### updateDefaultValues?
20β
21```ts
22optional updateDefaultValues?: boolean;
23```
24β
25Defined in: [FormApi/FormApi.public.ts:584](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/FormApi.public.ts#L584)
26β
27Whether `reset(values)` should also update the form's `defaultValues`
28baseline.
29β
30By default, passing values to `reset` treats those values as the new reset
31baseline. Future `reset()` calls will return to those values, and
32`state.isDefaultValue` will compare against them.
33β
34Set this to `false` when you want reset semantics for form state
35(clearing touched, dirty, validation, submission state, and mounted fields)
36but want to keep comparing against the previous `defaultValues`.
37β
38With `updateDefaultValues: false`, `state.isDirty` is reset to `false`,
39but `state.isDefaultValue` may be `false` if the provided reset values do
40not deeply equal the preserved defaults.
41β
42This option is ignored when no reset values are provided.
43β
44#### Example
45β
46```ts
47const originalDefaults = formApi.defaultValues
48β
49formApi.reset(savedDraft, { updateDefaultValues: false })
50// `savedDraft` is current, but `originalDefaults` remains the baseline.
51β
52formApi.reset()
53// Restores `originalDefaults`, not `savedDraft`.
54```