Téléversement de fichiers

NueForm's file upload question type lets respondents attach files to their form submissions. This guide covers how to set up file uploads, configure restrictions, and access uploaded files.

Setting Up a File Upload Question

1. Open your form in the NueForm builder.
2. Click the + button to add a new question.
3. Select File Upload from the question type list.
4. Configure the question title (e.g., "Upload your resume" or "Attach supporting documents").
5. Set the question as required if a file must be provided.

Supported File Types

NueForm accepts a wide range of file types. By default, all common file types are accepted. You can restrict accepted types in the question properties.

Common File Types

File Size Limits

The maximum file size per upload depends on your NueForm plan:

Storage Quotas

Each NueForm account has a total storage quota that covers all uploaded files across all forms. This includes:

• Files uploaded by respondents via file upload questions.
• Media files uploaded by you in the form builder (images, videos for question media).

Checking Your Storage Usage

Your current storage usage is tracked in your account settings. NueForm stores the total bytes consumed across all your uploads.

What Happens When You Hit the Limit

When your storage quota is reached:

• New file uploads from respondents will fail with an error message.
• Form submissions that include file uploads will be rejected.
• Other question types (text, choice, rating, etc.) are not affected.
• You can free up space by deleting old responses with file attachments.

How File Storage Works

NueForm stores uploaded files in Vercel Blob Storage:

1. When a respondent selects a file, it is uploaded directly to NueForm's storage.
2. Each file is assigned a unique UUID-based filename (e.g., a1b2c3d4.pdf) to prevent naming conflicts.
3. The original filename is preserved in metadata alongside the stored file.
4. The file's URL is stored as the answer value in the response.

The stored file record includes:

Accessing Uploaded Files

In the Responses Dashboard

When viewing a response in the NueForm dashboard, file upload answers display:

• The original filename.
• A download link to access the file.
• The file size.

Via the API

When you retrieve a response via the Responses API, file upload answers contain the file's storage URL:

{
  "questionId": "507f1f77bcf86cd799439033",
  "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}

You can download the file by making a GET request to this URL.

Via Webhooks

Webhook payloads include the file URL as the answer value:

{
  "event": "form.submitted",
  "formId": "...",
  "responseId": "...",
  "answers": [
    {
      "questionId": "507f1f77bcf86cd799439033",
      "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
    }
  ]
}

See Webhook Payloads for the full payload reference.

In CSV Exports

When you export responses as CSV, file upload answers appear as URLs in the CSV cells. You can click these URLs to download the files.

Configuring File Upload Properties

In the question properties panel, you can configure:

Multiple File Uploads

If you need respondents to upload multiple files, add multiple file upload questions to your form. Each question accepts one file, keeping the submission structured and organized.

For example:

• Question 1: "Upload your resume (PDF)"
• Question 2: "Upload your cover letter (PDF)"
• Question 3: "Upload your portfolio (PDF or ZIP)"

Meilleures pratiques

1. Be specific about what to upload. Use the question title and description to tell respondents exactly what file you need, in what format. For example: "Upload your resume as a PDF (max 10 MB)."

2. Set questions as required when appropriate. If the file is essential (e.g., a job application resume), mark the question as required. If it is optional (e.g., additional supporting documents), leave it optional.

3. Monitor storage usage. Check your storage quota periodically, especially if your forms receive high submission volume. Upgrade your plan if you are approaching the limit.

4. Process files promptly. If you use webhooks to receive file URLs, download and process the files on your end. Do not rely solely on NueForm's storage for long-term file archival.

5. Consider file naming in instructions. Ask respondents to name their files descriptively before uploading (e.g., "FirstName-LastName-Resume.pdf"), as NueForm preserves original filenames in metadata.

Dépannage

Voir aussi

• Question Types: Media --- Overview of media-related question types
• Webhook Payloads --- How file URLs appear in webhook data
• API Reference: Responses --- Accessing uploaded files via the API