> For the complete documentation index, see [llms.txt](https://shoppad.gitbook.io/uploadery/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shoppad.gitbook.io/uploadery/readme/create-and-display-upload-fields.md).

# Create and Display Upload fields

Upload fields are created, managed, and assigned to products on the Uploadery dashboard. This guide walks you through setting up your first one.

Before you start, make sure the Uploadery app block is installed on your storefront. If you haven't done that yet, start here: [Installing the Uploadery app block.](https://shoppad.gitbook.io/uploadery/readme/pages/zo3fp8GWqsQ1bUTtM9dn#installing-uploadery-on-a-2.0-theme)

### **What's an Option Set?**

Think of an option set as a package of upload fields. You build it once, assign it to the products that need it, and you're done. Some option sets are simple, just one field asking for a file. Others could display several upload fields on the product. 

The main benefit is reuse. If ten products need the same upload field, one option set covers all of them.

***

{% hint style="info" %}
**Note:** When you open the dashboard, Uploadery will sync your product catalog in the background. You'll see a "Catalog Sync Complete" message when it's done. You don't need to wait for it to start building your option set.
{% endhint %}

#### **Step 1: Create an Option Set**

From the Uploadery dashboard, click Create Option Set.

<figure><img src="/files/zew3v6pOyztt8EZNxB9x" alt=""><figcaption></figcaption></figure>

You can rename it right away by clicking on the Option Set 1 text. \
\
Give it a name that makes sense for the product you're setting it up for, like "Custom Artwork Upload" or "Personalization File." In this example, we have named the option set "Custom Shoe Colors."&#x20;

<figure><img src="/files/rPQNWe7neeZ4Dc4oXbkg" alt=""><figcaption></figcaption></figure>

#### Step 2: Set Up Your Upload Field

Click the gray arrow or the Label field to expand the configuration panel.

There are two fields to fill in first:

**Label** -- This is the heading customers see above the upload field on your product page. Keep it clear and descriptive, like "Upload Your Artwork" or "Upload Your Photo."

**Field Name** -- This is the label that appears at checkout and in the order details. It should be unique so you can easily identify which upload belongs to which field when reviewing orders.

<figure><img src="/files/nglFbrSpXHMAVvHKF78B" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Hovering over the ⓘ icon next to any field on the dashboard will bring up information detailing what the field is used for.
{% endhint %}

<figure><img src="/files/PeWbmw2IZv39tb2O6mtn" alt=""><figcaption></figcaption></figure>

#### **Step 3: Choose Accepted File Types**

Under file formats, you can choose what types of files customers are allowed to upload. Leaving it blank allows all file types.

If you want to limit it, you can select from preset categories: Image, Video, Audio, or Document. Selecting one will automatically include all file extensions in that category.

<figure><img src="/files/OKLh56wJHLUgblnCGGBS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pIPStYU4d0MfmXsxjemI" alt=""><figcaption></figcaption></figure>

#### **Step 4: Add More Fields (Optional)**

If your product needs more than one upload field, click Add Another Custom Field to add additional fields to the same option set.

<figure><img src="/files/Q5hKSsMs1NPPgiR3Xo3z" alt=""><figcaption></figcaption></figure>

#### **Step 5: Set Advanced Options (Optional)**

Click Show Advanced Options if you want more control over the field. You can skip this on your first setup and come back to it later.

<figure><img src="/files/0QcgzS5eunO28ACc0giq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wZTNLATuHsMKEep3kM7W" alt=""><figcaption></figcaption></figure>

Here's what each setting does:

* **Class Name** -- Only needed if you plan to use custom CSS to style the upload field. Leave it blank otherwise.
* **Maximum File Size** -- Sets a limit on how large a customer's uploaded file can be. Click Get more if you need a higher limit.

<figure><img src="/files/6wXzuE4kLgNmcMgSEJe6" alt=""><figcaption></figcaption></figure>

* **Required Field** -- Set to **Yes** if customers must upload a file before adding the product to their cart. Set to No to make it optional.

<figure><img src="/files/23DsThup8YxgXUeJXoaz" alt=""><figcaption></figcaption></figure>

* **In-Browser Image Editor** — this lets your customers crop and rotate images before submitting. You can also choose the output file format.

<figure><img src="/files/L3y1cgHhvzuVWIvsPKAG" alt=""><figcaption></figcaption></figure>

**Image Requirements** -- Lets you set specific aspect ratios or minimum and maximum dimensions for uploaded images. Uploadery supports square (1:1), portrait (4:5), landscape (16:9), and other aspect ratio-based crop areas.

&#x20;It does not include a circular crop mask. The image editor will always produce a rectangular file.

<figure><img src="/files/DvQsmQeWmFrYCyjOZdd0" alt=""><figcaption></figcaption></figure>

### **Step 6: Assign the Option Set to Products**

Now that your fields are set up, it's time to choose which products they'll appear on. At the top of the option set, you'll see the assignment section. This is where you define your assignment rule.

<figure><img src="/files/YePw3xZgAL35sgHJ0lTh" alt=""><figcaption></figcaption></figure>

For help with assignment rules, see: [Assigning Upload Fields to Products.](/uploadery/readme/assigning-upload-fields-excluding-a-few-products.md)

#### **Step 7: Save**

Click **Save.** Your upload fields should appear on your storefront within a few minutes.

If the fields aren't showing up after a few minutes, the app block may not be installed yet. Head to the installation guide to get that sorted: [Installing the Uploadery app block.](https://shoppad.gitbook.io/uploadery/readme/pages/zo3fp8GWqsQ1bUTtM9dn#installing-uploadery-on-a-2.0-theme)

#### **What's Next**

Once your first upload field is live, you're ready to start receiving files from customers. When an order comes in, you can download the uploaded file from the order details in your Shopify admin or directly from the Uploadery dashboard.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://shoppad.gitbook.io/uploadery/readme/create-and-display-upload-fields.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.