# Forms

You can build forms consisting of different fields in the Form Builder.

Tip

To learn how to get, create, and delete form submissions by using the PHP API, see [Form API](https://doc.ibexa.co/en/latest/content_management/forms/form_api/index.md).

Known limitation

To have multiple instances of the same form on one page, create several identical form blocks. Otherwise, you may encounter issues with submitting data from all forms at the same time.

## Existing Form fields

### Captcha field

The Captcha Form field is based on [Gregwar/CaptchaBundle](https://github.com/Gregwar/CaptchaBundle).

You can customize the field by adding configuration to `config/packages/gregwar_captcha.yaml` under `gregwar_captcha`:

```
gregwar_captcha:
    as_url: true
    width: 150
    invalid_message: Code does not match, please retry.
    reload: true
```

The example configuration above resizes the Captcha image (line 3), changes the error message (line 4), and enables the user to reload the code (line 5).

For information about available options, see [Gregwar/CaptchaBundle's documentation](https://github.com/Gregwar/CaptchaBundle#options).

Note

If your installation uses Varnish to manage content cache, you must modify the configuration to avoid issues with the Captcha field. For more information, see [Ensure proper captcha behavior](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/http_cache/reverse_proxy/#ensure-proper-captcha-behavior).

## Form submission purging

You can purge all submissions of a given form. To do this, run the following command, where `form-id` stands for Content ID of the form for which you want to purge data:

```
php bin/console ibexa:form-builder:purge-form-submissions [options] [--] <form-id>
```

The following table lists some of the available options and their meaning:

| Switch | Option                          | Description                                                                                                               |
| ------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `-l`   | `--language-code=LANGUAGE-CODE` | Passes a language code, for example, "eng-GB".                                                                            |
| `-u`   | `--user[=USER]`                 | Passes a repository username. By default it's "admin".                                                                    |
| `-c`   | `--batch-size[=BATCH-SIZE]`     | Passes a number of URLs to check in a single iteration. Set it to avoid using too much memory. By default it's set to 50. |
|        | `--siteaccess[=SITEACCESS]`     | Passes a SiteAccess to use for operations. If not provided, the default SiteAccess is used.                               |

## Form-uploaded files

You can use Forms to enable the user to upload files. The default location for files uploaded in this way is `/Media/Files/Form Uploads`. You can change it with the following configuration:

```
ibexa:
    system:
        default:
            form_builder:
                upload_location_id: 54
```

This applies only if no specific location is defined in the Form itself.