A flexible JavaScript File Uploader that works with every stack
FilePond uploads anything you throw at it, and offers an accessible, silky smooth user experience.
Get Started
npm i filepond@latest
Easily Integrates with your Favorite Frameworks
The FilePond web component is fully typed and works with any JavaScript framework…
…and thanks to Shadow DOM, FilePond plays nicely with CSS frameworks too.
Tailwind
Skeleton
Foundation
Bootstrap
If frameworks aren't your thing, you can just use with plain ol' HTML, CSS, and JS.
Browser, OS, and Device compatibilityFeature Highlights
-
Turn Anything into a File
Load directories, files, blobs, canvas elements, data transfers, local URLs, remote URLs, and data URLs.
-
Upload Sync or Async
Synchronous uploading by default, easily expand to async, chunked, or custom uploading with extensions.
-
Add Data from Anywhere
Supports drag and drop, copy and paste, select with file input, or load files using the API.
-
Optimise and Edit Images
Automatically validate, orient, crop, resize, and compress images on the client for reduced bandwidth usage and faster uploads.
-
Accessible Defaults
Tested with AT software, internationalisation, right-to-left text support, fully navigable with keyboard, mouse, and touch interaction.
-
Great UX on any Device
Finely tuned touch areas, optimised drag and drop functionality. Fully functional and performant on both mobile and desktop devices.
A Custom Element that Just Works
The <file-pond> custom element feels right at home on a classic webpage. Wrap it around any file input and it just works, no server changes required.
<form action="/upload" method="POST">
<label for="my-file">Document</label>
<file-pond>
<input id="my-file" type="file" name="doc" />
</file-pond>
<button type="submit">Upload</button>
</form>
<script type="module">
import { defineFilePond } from 'filepond';
import { locale } from 'filepond/locales/en-gb.js';
defineFilePond({ locale });
</script>
When <file-pond> is integrated with a JavaScript Framework it behaves just like a component.
import { defineFilePond } from 'filepond';
import { locale } from 'filepond/locales/en-gb.js';
defineFilePond({ locale });
export default function App() {
const [myEntries, setMyEntries] = useState<FilePondEntry[]>([]);
return (
<label htmlFor="my-file">Document</label>
<file-pond entries={myEntries}>
<input id="my-file" type="file" name="doc" />
</file-pond>
);
}
Beautiful Image and Video Previews
If the browser can present it, so can FilePond, extend default options with
For optimal performance media previews are rendered on a separate thread.
Easily Extendable
Import only the parts you need and add functionality to FilePond with 28 ready made extensions.
Build your own source, store, transform, and validation extensions, or start from scratch and create a fully custom extension.
-
source
Source extensions get a file source from the user and can optionally create a source button in the sources list. You can easily create your own source extension extension using the
createSourceExtensionfactory.-
CameraSource
Adds a camera source button to the FilePond sources list.
-
ClipboardSource
Accept files from paste events.
-
DragDropSource
Accept files dropped on the document
-
FileInputSource
Accept files from a specified file input element
-
URLInputSource
Adds a url input source to the FilePond sources list.
-
-
load
Load extensions turn a file source into a
Fileobject.-
BlobLoader
Convert Blob sources into Files.
-
CanvasLoader
Convert Canvas sources into Blobs.
-
DataTransferLoader
Convert a DataTransfer into a File tree.
-
URLLoader
Convert URL sources into Files.
-
SimulatedLoader
Simulate File loading.
-
-
validate
Validate extensions test if a
Fileobject is allowed to be uploaded. Custom validate extensions can be created using thecreateValidatorExtensionfactory.-
FileExtensionValidator
Validate files based on their extension.
-
FileMimeTypeValidator
Validate files based on their mime type.
-
FileNameValidator
Validate files based on their name.
-
FileSizeValidator
Validate files based on their min and/or max size.
-
ListCountValidator
Validate the file list based on the amount of files in the list.
-
ListSizeValidator
Validate the file listsize based on the total size of the files in the list.
-
MediaResolutionValidator
Validate images and videos based on their width and height values. Use with
ImageBitmapTransformto automatically optimise valid images before upload.
-
-
transform
Transform extensions transform a
Fileobject into anotherFileobject, for example to compress a file with a client-side compression library. Use thecreateTransformExtensionfactory to create your own file transforms.-
FileNameTransform
Automatically or manually rename files.
-
ImageBitmapTransform
Automatically orient, crop, resize, and compress images. Use with
MediaResolutionValidatorto filter out and optimise unwanted images before upload.
-
-
store
Store extensions put a
Fileobject in a storage location. ThecreateStoreExtensionfactory can be used to create custom store extensions.-
DataURLStore
Store the encoded data URL of the file.
-
FormPostStore
Store the file object using a form post.
-
ChunkedUploadStore
Store the file object by uploading it in chunks.
-
SimulatedStore
Simulate storing a file.
-
TextInputStore
Store a stringified representation of the current entry tree in a specified input element.
-
ValueCallbackStore
Handle storage with a callback function.
-
-
resource
Resource extensions add derived resources to a file entry.
-
ObjectURLResource
Creates an ObjectURL for a file entry and adds it to the entry. Automatically revokes the ObjectURL when the file data changes or when the file is removed.
-
-
view
View extensions display the current entry list and extension state to the user.
-
ConsoleView
Renders the current state of the file tree to the developer console.
-
EntryListView
Renders the current state of the file tree to a specified HTML element.
-
Fits in with Light and Dark Themes
FilePond uses the CSS color-scheme property to make switching between light and dark mode super easy.
Experiment with style presets below. Of course you can customize every aspect of FilePonds appearance.
Palls with Pintura
Pair FilePond with Pintura to unlock the perfect image and video editing experience for your users.
- Five minute install
- Set crop masks and guides
- Control quality with fixed aspect ratios
- Rotate, resize, and flip images
- Annotate, decorate, and redact Images
- Finetune image colors
- Inpainting support
- As beautifully animated as FilePond
Animated with the power of springs
FilePond automatically animates the user interface using springs. By default it respects users that prefer reduced motion.
Experiment with spring animation settings and FilePond layouts below.
About FilePond
FilePond is built by Rik Schennink at Pqina. Pqina helps more than 10,000 companies worldwide to be successful on the web and is rated 4.9 out of 5 stars by 500+ customers.
When given the attention it deserves, the web can rival the native experience.
![]()