File upload

A File upload component helps users select and upload a file.

from django import forms

from crispy_forms_gds.helper import FormHelper
from crispy_forms_gds.layout import HTML, Layout, Submit


class FileUploadForm(forms.Form):

    file = forms.FileField(
        label="Upload a file",
        help_text="Select the CSV file to upload.",
        error_messages={
            "required": "Choose the CSV file you exported from the spreadsheet"
        },
    )

    def __init__(self, *args, **kwargs):
        super(FileUploadForm, self).__init__(*args, **kwargs)
        self.helper = FormHelper()
        self.helper.layout = Layout("file", Submit("submit", "Submit"))

You can see this form live in the Demo site.

The Design System adds some styling but other than that file upload is a vanilla <input[type=file]> element.