silverstripe-userforms/docs/en/03_troubleshooting.md

---
title: Troubleshooting
---

# Troubleshooting

Check the below if you have any issues during installation or use

## Installation issues

After installation make sure you have done a `dev/build` you may also need to flush the admin view by appending
`?flush=1` to the URL, e.g. `https://example.com/admin?flush=1`

## Checkbox or radio group custom messages not showing

If your project has a custom template for `UserFormsCheckboxSetField.ss` or `UserFormsOptionSetField.ss`, then you will need to ensure they include `$Top.getValidationAttributesHTML().RAW`. See

- [UserFormsCheckboxSetField.ss](../../templates/SilverStripe/UserForms/FormField/UserFormsCheckboxSetField.ss)
- [UserFormsOptionSetField.ss](../../templates/SilverStripe/UserForms/FormField/UserFormsOptionSetField.ss)

## UserForms `EditableFormField` column clean task

This [`UserFormsColumnCleanTask`](api:SilverStripe\UserForms\Task\UserFormsColumnCleanTask) task is used to clear unused columns from EditableFormField database tables.

The reason to clear these columns is because having surplus forms can break form saving.

Currently it only supports MySQL and when it is run it queries the EditableFormField class for the valid columns,
it then grabs the columns for the live database. It will create a backup of the table and then remove any columns that
are surplus.

To run the task, log in as an administrator and go to `https://example.com/dev/tasks/UserFormsColumnCleanTask` in your browser, or run `sake dev/tasks/UserFormsColumnCleanTask` from the command line.

## My CSV export times out or runs out of memory

You likely have too many submissions to fit within the PHP constraints
on your server (execution time and memory). If you can't increase these limits,
consider installing the [gridfieldqueuedexport](https://github.com/silverstripe/silverstripe-gridfieldqueuedexport) module. It uses [queuedjobs](https://github.com/symbiote/silverstripe-queuedjobs) to export
submissions in the background, providing users with a progress indicator.
DOC Linting 2024-04-09 06:04:13 +02:00			`---`
			`title: Troubleshooting`
			`---`

Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00			`# Troubleshooting`

			`Check the below if you have any issues during installation or use`

DOC Linting 2024-04-09 06:04:13 +02:00			`## Installation issues`
Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00
			After installation make sure you have done a `dev/build` you may also need to flush the admin view by appending
DOC Linting 2024-04-09 06:04:13 +02:00			`?flush=1` to the URL, e.g. `https://example.com/admin?flush=1`
Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00
DOC Linting 2024-04-09 06:04:13 +02:00			`## Checkbox or radio group custom messages not showing`
FIX Show custom validation message for checkbox and radio groups 2020-07-21 07:30:55 +02:00
			If your project has a custom template for `UserFormsCheckboxSetField.ss` or `UserFormsOptionSetField.ss`, then you will need to ensure they include `$Top.getValidationAttributesHTML().RAW`. See

DOC Linting 2024-04-09 06:04:13 +02:00			`- [UserFormsCheckboxSetField.ss](../../templates/SilverStripe/UserForms/FormField/UserFormsCheckboxSetField.ss)`
			`- [UserFormsOptionSetField.ss](../../templates/SilverStripe/UserForms/FormField/UserFormsOptionSetField.ss)`

			## UserForms `EditableFormField` column clean task
Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00
DOC Linting 2024-04-09 06:04:13 +02:00			This [`UserFormsColumnCleanTask`](api:SilverStripe\UserForms\Task\UserFormsColumnCleanTask) task is used to clear unused columns from EditableFormField database tables.
Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00
			`The reason to clear these columns is because having surplus forms can break form saving.`

			`Currently it only supports MySQL and when it is run it queries the EditableFormField class for the valid columns,`
DOCS Update dev and userguide docs for SS4, new screenshots, etc 2017-09-20 06:31:12 +02:00			`it then grabs the columns for the live database. It will create a backup of the table and then remove any columns that`
Added user documentation. Split README.md and docs/en/index.md so that One is targeted towards users visiting the github repo, and the other for browsing a documentation repository. 2014-07-22 04:03:03 +02:00			`are surplus.`

DOC Linting 2024-04-09 06:04:13 +02:00			To run the task, log in as an administrator and go to `https://example.com/dev/tasks/UserFormsColumnCleanTask` in your browser, or run `sake dev/tasks/UserFormsColumnCleanTask` from the command line.
Suggest installing gridfieldqueuedexport 2016-11-28 04:45:52 +01:00
			`## My CSV export times out or runs out of memory`

			`You likely have too many submissions to fit within the PHP constraints`
			`on your server (execution time and memory). If you can't increase these limits,`
DOCS Update dev and userguide docs for SS4, new screenshots, etc 2017-09-20 06:31:12 +02:00			`consider installing the [gridfieldqueuedexport](https://github.com/silverstripe/silverstripe-gridfieldqueuedexport) module. It uses [queuedjobs](https://github.com/symbiote/silverstripe-queuedjobs) to export`
			`submissions in the background, providing users with a progress indicator.`