> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brikl.co/llms.txt
> Use this file to discover all available pages before exploring further.

# File Uploader 01

> Centered file uploader with image preview, upload button, filename display, and remove option.

<Frame>
  ![File Uploader 01](https://ffciaqoksnnzuihswbxs.supabase.co/storage/v1/object/public/components/Elements/File%20Uploaders/file-uploader-basic.png)
</Frame>

## Overview

File Uploader 01 is a Bubble.io UI component that allows users to upload image files through a styled button interface. It displays a live preview of the uploaded image, dynamically changes the button label from 'Upload image' to 'Change image' once a file is selected, shows the filename, and provides a 'Remove' button to clear the selection. The component handles all states visually including hover, disabled, and file-selected states.

## How to use

<Steps>
  <Step titleSize="h4" title="Open the Brikl panel">
    Navigate to the **Elements** category in the Brikl panel.
  </Step>

  <Step titleSize="h4" title="Copy the component">
    Find **File Uploader 01** and click **Copy**.
  </Step>

  <Step titleSize="h4" title="Paste into your editor">
    Paste it into your Bubble canvas with `Cmd + V` (Mac) or `Ctrl + V` (Windows),
    or right-click on the canvas and select **Paste**.
  </Step>
</Steps>

## States

This component includes conditional states that automatically change its appearance.

| State                                | Trigger                            | Visual effect                                                                                                                                           |
| ------------------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| File Selected – Preview Visible      | FileUploader 01 value is not empty | The preview group displays the uploaded image as a background, the icon inside preview is hidden, and the upload button label changes to 'Change image' |
| File Empty – Remove Group Hidden     | FileUploader 01 value is empty     | The remove button and filename group are hidden from view                                                                                               |
| File Selected – Remove Group Visible | FileUploader 01 value is not empty | The group containing the Remove button and filename becomes visible                                                                                     |
| File Uploader Hovered                | FileUploader 01 is hovered         | The upload button opacity increases to 90                                                                                                               |
| File Uploader Not Clickable          | FileUploader 01 is not clickable   | The upload button opacity reduces to 50, indicating a disabled state                                                                                    |
| Remove Button Hovered                | Remove button is hovered           | Underline appears on the Remove button text                                                                                                             |

<Note>
  These states are handled natively by Bubble and require no additional setup.
  They will work automatically once the component is pasted into your editor.
</Note>

## Responsive

This component adapts to mobile screens. Font sizes and layout automatically adjust on screens smaller than Bubble's built-in mobile breakpoint.

## Workflows

This component includes pre-built workflows.

| Trigger                        | Action                                                                                                            |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| BT - Remove (FU 01) is clicked | Resets the group GP - BT File Uploader 01, clearing the file input and reverting the component to its empty state |

<Note>
  These workflows are included when you use the **Copy with Workflows** option in the Brikl panel.
</Note>

## Requirements

|             |                       |
| ----------- | --------------------- |
| License     | Starter plan required |
| Plugins     | None                  |
| Custom code | Not required          |

## Platforms

| Platform | Supported |
| -------- | --------- |
| Web      | ✅         |
| Mobile   | ❌         |

## License

<Note>
  This component requires a **Starter** plan.
</Note>