> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loadforge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submitting Forms

> Examples of how to submit forms during your load tests.

Testing form submissions is a **crucial part of load testing**. Many applications rely on forms for authentication, data collection, and business logic (e.g., **logins, signups, contact forms**).

There are multiple ways to submit form data, including **traditional web forms** and **JSON-based API submissions**. Below are examples of both methods.

<Note>
  **Tip:** Use LoadForge’s **Browser Recorder** to automatically capture and replay form submissions. This simplifies setting up real-world interactions.
</Note>

## Submitting Standard Web Forms

A standard **HTML form submission** involves sending form data via a `POST` request. Below is an example of a **contact form submission** in LoadForge:

### Example: Contact Form Submission

```python theme={null}
from locust import HttpUser, task, between

class QuickstartUser(HttpUser):
    wait_time = between(3, 5)

    @task(2)
    def contact(self):
        self.client.post("/contact", {
            'email': 'user@domain.com',
            'subject': 'LoadForge Test',
            'message': 'This is a test form submission from LoadForge.'
        })
```

### Handling Redirects

Many form submissions trigger **redirects** (e.g., login forms). If your test needs to **follow a redirect**, add `allow_redirects=True`:

```python theme={null}
self.client.post("/login", {"username": "test", "password": "secure"}, allow_redirects=True)
```

For more examples, see:

* [Login Examples](https://loadforge.com/directory/login-examples)

## Submitting JSON Data

Modern applications often use **APIs** to handle form data as JSON payloads. Below is an example of **submitting JSON data** in LoadForge:

### Example: JSON POST Request

```python theme={null}
import json
from locust import HttpUser, task, between

class QuickstartUser(HttpUser):
    wait_time = between(3, 5)

    @task(1)
    def post_json(self):
        payload = {
            'username': 'test_user',
            'password': 'secure_password'
        }
        headers = {'Content-Type': 'application/json'}
        self.client.post("/api/login", data=json.dumps(payload), headers=headers)
```

### Common API Issues

If your JSON form submissions fail, check for:

1. **Incorrect Content-Type** – Ensure `Content-Type: application/json` is set.
2. **Missing Headers** – Some APIs require authentication tokens.
3. **CSRF Protection** – Some web apps reject requests without a CSRF token.

For more details, see:

* [JSON Examples](https://loadforge.com/directory/json-posts)

## Debugging Form Submissions

If your test isn’t working, try:

* **Manually submitting the form in your browser** and checking network requests in **Developer Tools > Network Tab**.
* **Using LoadForge’s Debugger** to analyze failed requests.
* **Enabling logging** to capture detailed request responses:
  ```python theme={null}
  response = self.client.post("/contact", data={...})
  print(response.status_code, response.text)
  ```

By mastering form submissions, you can **simulate real user behavior**, ensuring your application performs well under load. 🚀