> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://help.sigmacomputing.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server. # Create and configure a file upload control (Beta) This documentation describes one or more public beta features that are in development. Beta features are subject to quick, iterative changes; therefore the current user experience in the Sigma service can differ from the information provided in this page. This page should not be considered official published documentation until Sigma removes this notice and the beta flag on the corresponding feature(s) in the Sigma service. For the full beta feature disclaimer, see [Beta features](/docs/sigma-product-releases#beta-features). Use file upload controls to upload images, documents, and videos to file columns in input tables. You can add a file upload control as a standalone element in a workbook, or you can use it in a form with [**Insert row**](/docs/create-actions-that-modify-input-table-data#insert-row) and [**Update row(s)**](/docs/create-actions-that-modify-input-table-data#update-rows) actions to build an app that supports file uploads. File columns can accept the following file types, which can be restricted in the control properties or in the destination [file column](/docs/configure-file-upload-columns-on-input-tables#configure-file-upload-restrictions) configurations: * Images: JPEG/JPG, PNG, GIF, TIFF, BMP, WebP, SVG * Documents: PDF, CSV, DOC/DOCX, XLS, XLSX, Pages, Numbers, Keynote, JSON, Text file, XML * Videos: MP4, MOV, AVI, MKV, WebM, M4V You can also limit the number of files per upload and set a maximum size per file. This document explains how to add a file upload control to a workbook and configure restrictions, format, and upload destinations. ## Requirements The ability to create and configure a file upload control requires the following: * Your organization must have an existing storage integration for file uploads. See [External storage integration overview](/docs/external-storage-integration-overview) to review the available configuration options. * You must be assigned an [account type](/docs/account-type-and-license-overview) with the **Create, edit, and publish workbooks** permission enabled. * You must be the workbook owner or be granted **Can edit** [workbook permission](/docs/folder-and-document-permissions) . ## Add a file upload control Add a file upload control to your workbook. 1. Open a workbook draft. 2. In the **Add element** bar, choose **Controls** > **File upload**. ![](https://files.buildwithfern.com/sigma.docs.buildwithfern.com/8133f1b23434804f7347ba67506fe165cbb09aed98ff0695411c9bc2834a7221/assets/docs-images/40872e628cff957400751d8c7732e6a854777cf31df1e744ddfa001a2370926c-image.png) Sigma adds a new file upload control to the workbook. ![](https://files.buildwithfern.com/sigma.docs.buildwithfern.com/5e0c68e1f04d7f2cb4a5a1574e32d96f3965e40db614332d986c2d88a7817e18/assets/docs-images/a40cb35d5d67bc367c89686679d87dfc08c324d68517a138c457c3ba06e3c8ad-image.png) ## Configure file upload restrictions Configure file upload restrictions for security, compliance, and performance purposes. You can add file upload validation to restrict the following: * Number of files users can upload simultaneously * Accepted file types * Maximum size per file By default, a file upload control allows multiple files per cell (without restriction), accepts all supported file types, and has a 200 MB maximum file size. File upload restrictions can also be set in the destination [file column](/docs/configure-file-upload-columns-on-input-tables#configure-file-upload-restrictions) configurations. When there are different restrictions on the control and the file column, the most restrictive settings are applied when uploading files using the control. 1. With the control selected, open the **Properties** panel. 2. In the **Settings** tab, configure the following options: | | | | :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Allow multiple files** | To allow users to upload multiple files simultaneously, select the checkbox. To limit each upload to a single file, clear the checkbox. | | **Restrict number of files** | When you allow multiple files per upload, you can set a maximum number of files users can upload simultaneously. To limit the number of files, select the **Restrict number of files** checkbox, then enter the file limit in the **Max number** field (displayed when the checkbox is selected). | | **Accepted file types** | Select the file types users are allowed to upload. A checkmark displays next to accepted file types, unless all are accepted (then no checkmarks display). | | **Max size** | Enter the maximum size allowed per file. | ## Format a file upload control In the **Format** panel, you can customize the appearance of a file upload control to match the styling of your workbook. Customizable formatting includes the following: * [Element style](#customize-element-styles) * [Label](#customize-the-element-label) * [Alignment](#customize-element-content-alignment) ### Customize element styles Customize the appearance of the element container. For more information, see [Customize element background and styles](/docs/customize-element-background-and-styles). | Element style | | | :--------------- | :--------------------------------------------------------------------------- | | Padding | Add space between the edges of the element and its contents. | | Background color | Fill the empty space of the element with a specific color. | | Border | Add a border around the edges of the element container. | | Corner | Change the corners of the element container to square, round, or pill shape. | ### Customize the element label Customize the appearance of the element label. | Label | | | :------------------ | :-------------------------------------------------------------------------------------------------------------------------- | | Show label | Show or hide the element label text. | | Label | Edit the content of the element label text, and customize the font weight and color. | | Label position | Display the element label above or to the left of the **Browse** button. | | Show description | Show or hide a description of the control. Edit the description text, and customize the font weight and color. | | Description display | Display the description as a subtitle or tooltip, or choose **Auto** to display it dynamically based on the element height. | ### Customize element content alignment In the **Alignment** section, you can customize the **Vertical** setting to reposition the element content relative to the total element height. ## Configure the file upload destination Unlike other control types, file upload controls don't have a **Target** tab in the **Properties** panel. To configure one or more file upload destinations, you must configure an **Insert row** or **Update row** action and pass the file upload control object to a file column in an input table. For more information, see [Create actions that modify input table data](/docs/create-actions-that-modify-input-table-data).