---
title: "Response.submitForm( [params] ) | Grafana k6 documentation"
description: "Fill in and submit form found in HTML of response."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Response.submitForm( \[params] )

Fill in and submit form found in HTML of response. By default it will look for the first `form` tag in the HTML, but this can be overridden using the `formSelector` option. To set/override the form fields you set properties of an object in the `fields` option.

This method takes an object argument where the following properties can be set:

Expand table

| Param          | Type   | Description                                                                                                                                                                                     |
|----------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| formSelector   | string | A selector string passed to [Selection.find(selector)](/docs/k6/latest/javascript-api/k6-html/selection/selection-find/) to locate the form to fill in and submit. By default this is `"form"`. |
| fields         | object | The form fields to set/override. The keys are the form fields names and the values are the form field values.                                                                                   |
| submitSelector | string | A selector string used to locate the submit button in the form. By default this is `'[type="submit"]'`.                                                                                         |
| params         | object | A [Params (k6/http)](/docs/k6/latest/javascript-api/k6-http/params/) object that will be forwarded to the form submit request. Can be used to set headers, cookies etc.                         |

### Returns

Expand table

| Type                                                                   | Description               |
|------------------------------------------------------------------------|---------------------------|
| [Response (k6/http)](/docs/k6/latest/javascript-api/k6-http/response/) | The form submit response. |

### Example

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  // Request page containing a form
  let res = http.get('https://quickpizza.grafana.com/admin');

  // Now, submit form setting/overriding some fields of the form
  res = res.submitForm({
    formSelector: 'form',
    fields: { username: 'test', password: 'test2' },
  });
  sleep(3);
}
```