> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/uploadery.md).

# Uploadery

### Configuration <a href="#configuring" id="configuring"></a>

#### Uploadery Order Created Trigger <a href="#create" id="create"></a>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-3bd81a6fbfd407a0aa530c874170b9247b1821af%2FDW-uploadery-trigger.png?alt=media" alt="Screenshot of the Uploadery Order Created trigger step in the MESA workflow builder. Spotlight the Uploadery trigger step."><figcaption></figcaption></figure>

This step is used when you want to collect any files the customer uploads on orders that have upload fields from your Uploadery app.

Optionally, select the **Field Name** of a specific Uploadery field to only filter for that upload field.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-0185177f5466d283f13cf85d8aeb4444f35869df%2FDW-uploadery-field-name.png?alt=media" alt="Screenshot of the Uploadery trigger configuration in the MESA workflow builder. Spotlight the Field Name dropdown."><figcaption></figcaption></figure>

If the field is left empty, it will return all file upload details.

### Potential Use Cases with Uploadery <a href="#potential" id="potential"></a>

**Add a tag to an order based on an Uploadery file**

Follow the steps below to add an order tag based on a file upload added by the customer.

1\. From the **My workflows** page, click on **New Workflow** to start a new workflow.\
\
2\. Select **Uploadery** as the Trigger of the workflow.\
\
In this example, I will be selecting the **Image** Uploadery Field to filter this step to proceed based on the File upload field being used on the order.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-dd3067d832af1ddd6116452d33fa29a9b61dd9fd%2FDW-uploadery-image.png?alt=media" alt="Screenshot of the Uploadery trigger configuration in the MESA workflow builder. Spotlight the Field Name dropdown set to Image."><figcaption></figcaption></figure>

3\. Select **Shopify** from the apps list and click **Use This** on the **Order Add Tag** action when it populates.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-33e90e77b37675a3052c3aabc779e0b7b0ef708f%2FDW-uploadery-order-add-tag.png?alt=media" alt="Screenshot of the Shopify actions list in the MESA workflow builder. Spotlight the Use This button on the Order Add Tag action."><figcaption></figcaption></figure>

4\. In the **Shopify Order Update step**, add the **Uploadery Order Created Order ID** to the required **Order ID** field by clicking the [variables](/workflow-builder/fields/variables.md) menu icon {+} and selecting the **ID** variable. This may automatically populate for you.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-b24d9426bbf14a6f42e199a256857249349bd2da%2FDW-uploadery-order-id.png?alt=media" alt="Screenshot of the Shopify Order Add Tag step in the MESA workflow builder. Spotlight the Order ID field populated with the ID variable."><figcaption></figcaption></figure>

5\. Add the tag you want to apply to the order by entering it in the **Tag** field of the **Shopify Order Add Tag** step.

In this example, I will add the tag **Personalized** to the order.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-c6d0f413f2c85bcfde849d0158449153e1608730%2FDW-uploadery-tag.png?alt=media" alt="Screenshot of the Shopify Order Add Tag step in the MESA workflow builder. Spotlight the Tag field with the Personalized tag entered."><figcaption></figcaption></figure>

6\. When you’re finished, your workflow should look like this.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-08cb0da6bf9cdc89cf94001254476f052c00403e%2FDW-uploadery-workflow.png?alt=media" alt="Screenshot of the completed Uploadery to Shopify Order Add Tag workflow in the MESA workflow builder. Show the full workflow overview."><figcaption></figcaption></figure>

7\. Turn the workflow on and complete some of the [best practices for MESA](/best-practices.md). You are good to go now! Any orders using the File upload field will now be automatically tagged with a Personalized tag.

5\. At the top of the workflow, hit the **Save** button to save your changes.

6\. Hit the toggle to switch it to **On** when you are ready to start using the workflow.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-f0449b7c60393bb1fca1aa246f8f7d90b958636e%2FDW-uploadery-enable.png?alt=media" alt="Screenshot of the Uploadery workflow in the MESA workflow builder. Spotlight the workflow On toggle."><figcaption></figcaption></figure>
