---
title: "How to Add File Uploads to Contact and Cancellation Forms"
description: "Let customers attach a file to an Order Editing contact or cancellation request."
url: https://docs.orderediting.com/en/articles/15323710-how-to-add-file-uploads-to-contact-and-cancellation-forms
collection: "App Blocks"
updated: 2026-08-27
language: en
---

# How to Add File Uploads to Contact and Cancellation Forms

Let customers attach a file to an Order Editing contact or cancellation request.

# Add a file upload field

Add a file upload when a customer needs to send evidence with a contact or cancellation request, such as a photo of damage, a receipt, or a supporting document.

Each uploaded file can be up to 4 MB. Order Editing saves uploads to Shopify Files, so the app must have Shopify's **write\_files** permission.

# Before you begin

-   The customer's order must match the editing rule that contains the form.
    
-   A contact or cancellation form can contain up to 10 custom fields in total.
    
-   Customers can only use the contact form when the **Support Tickets** app block is enabled in Shopify.
    

# Open the form settings

1.  In Order Editing, open **App Settings**.
    
2.  Select **Global settings**.
    
3.  Open **Editing Rules and Automations**.
    
4.  Open the editing rule that should collect the file.
    
5.  Open **Contact form** or **Cancellation form**.
    

The field only appears on orders that match this rule.

# Add an upload to a contact form

1.  Open **Contact form**.
    
2.  Select **File upload** under the form preview.
    
3.  Enter a clear customer-facing label, such as `Upload a photo of the damaged item`.
    
4.  Under **Accepted file types**, choose one of the available groups:
    
    -   **All file types**
        
    -   **Images (all formats)**
        
    -   **Images and PDFs**
        
    -   **PDF only**
        
    -   **Documents (PDF, DOC, DOCX)**
        
    -   **Spreadsheets (CSV, XLS, XLSX)**
        
5.  Turn on **Required** if the customer must attach a file before submitting the form.
    
6.  Save the editing rule.
    

New file fields accept **Images and PDFs** by default.

# Add an upload to a cancellation form

1.  Open **Cancellation form**.
    
2.  Go to **Additional questions**.
    
3.  Set **Field type** to **File upload**.
    
4.  Select **Add field**.
    
5.  Enter the label the customer should see.
    
6.  Turn on **Required** if an attachment is compulsory.
    
7.  In **Accepted file types**, enter the types you want to allow.
    
8.  Save the editing rule.
    

The default value is `image/*,.pdf`, which accepts images and PDF files. You can enter extensions such as `.doc,.docx` or use a category such as `image/*`. Leave the field empty to allow any file type.

# Approve the Shopify Files permission

If the form shows a file-permission warning:

1.  Select the permission action in the warning.
    
2.  Approve access to Shopify Files.
    
3.  Return to the editing rule.
    
4.  Confirm the warning has cleared.
    

Until this permission is approved, customers cannot upload a file. A required file field is not enforced when uploads are unavailable, so customers are not trapped in a form they cannot submit.

# Test the upload

1.  Open an existing eligible order that matches the editing rule.
    
2.  Open the customer-facing contact or cancellation form.
    
3.  Upload an allowed file smaller than 4 MB.
    
4.  Submit the form.
    
5.  In Shopify admin, confirm the uploaded file is present in **Content > Files**.
    
6.  Confirm the submitted request contains the attachment link.
    

If the field does not appear, check the editing-rule match and the form's custom-field limit. For a contact form, also confirm the **Support Tickets** app block is enabled. If the field appears but the upload fails, check the file size, accepted file types, and Shopify Files permission.

## Related

- [Setting Up Checkout Line Item Editing](https://docs.orderediting.com/en/articles/15311167-setting-up-checkout-line-item-editing.md)
- [Shipping Address Edits](https://docs.orderediting.com/en/articles/14154099-shipping-address-edits.md)
- [Change Products](https://docs.orderediting.com/en/articles/14154149-change-products.md)
- [Quantity Edits](https://docs.orderediting.com/en/articles/14154273-quantity-edits.md)
- [Product Search](https://docs.orderediting.com/en/articles/14154310-product-search.md)