# FormSubmitContext

Defined in: [FormApi/formSubmit.public.ts:116](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L116)

Form values, validator outputs, and error helpers passed to `onSubmit` after
submission validation succeeds.

## Type Param

**TFormErrorTypes**

Library-managed. Do not specify explicitly.

## Type Parameters

### TFormData

`TFormData`

Library-managed. Do not specify explicitly.

### TValidatorOutputs

`TValidatorOutputs` *extends* readonly `unknown`[]

Library-managed. Do not specify explicitly.

## Properties

### createErrorMap

```ts
createErrorMap: CreateSubmitErrorMapFn<TFormData>;
```

Defined in: [FormApi/formSubmit.public.ts:171](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L171)

Builds a mutable submission error map from optional initial errors. Return
the map to apply its form and field errors. An empty map indicates success.

***

### createValidationError

```ts
createValidationError: CreateValidationErrorFn<TFormData>;
```

Defined in: [FormApi/formSubmit.public.ts:166](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L166)

Creates a validation error recognized as a submission failure when returned
from a submission handler. Creating the error alone does not update form or
field validation state.

***

### formApi

```ts
formApi: FormApi<TFormData, ScopedErrorTypes<never, never>>;
```

Defined in: [FormApi/formSubmit.public.ts:123](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L123)

The form instance handling this submission.

***

### parseIssues

```ts
parseIssues: ParseSubmitIssuesFn<TFormData>;
```

Defined in: [FormApi/formSubmit.public.ts:176](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L176)

Converts Standard Schema issues into a mutable submission error map using
the submitted values. Return the map to report its form and field errors.

***

### validatorOutputs

```ts
validatorOutputs: TValidatorOutputs;
```

Defined in: [FormApi/formSubmit.public.ts:160](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L160)

The validator outputs from this submission.

Standard Schemas provide their output data automatically. Callback
validators must return a `createOutput` result to provide output data.

Outputs follow the same order as the validators array.

Skipped validators and successful returns without output contribute
`undefined`.

Outputs from earlier change, blur, or mount validation are not reused.

#### Example

```ts
formOptions({
  defaultValues: { name: '' },
  validators: [
    {
      run: ({ createOutput, value }) => {
        return createOutput({ displayName: value.name.trim() })
      },
    },
    {
      // Schemas pass their output data by default.
      run: mySchema,
    },
  ],
  onSubmit: ({ validatorOutputs }) => {
    // Outputs follow the same order as the validators array.
    const [customData, schemaOutput] = validatorOutputs
    console.log(customData.displayName)
  },
})
```

***

### value

```ts
value: TFormData;
```

Defined in: [FormApi/formSubmit.public.ts:121](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi/formSubmit.public.ts#L121)

The form values for this submission, without schema transformations applied.
