Docs

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 logoTailwind
  • Skeleton logoSkeleton
  • Foundation logoFoundation
  • Bootstrap logoBootstrap

If frameworks aren't your thing, you can just use with plain ol' HTML, CSS, and JS.

Browser, OS, and Device compatibility

Feature Highlights

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.

Learn more about setting up media previews

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 createSourceExtension factory.

  • load

    Load extensions turn a file source into a File object.

  • validate

    Validate extensions test if a File object is allowed to be uploaded. Custom validate extensions can be created using the createValidatorExtension factory.

  • transform

    Transform extensions transform a File object into another File object, for example to compress a file with a client-side compression library. Use the createTransformExtension factory to create your own file transforms.

  • store

    Store extensions put a File object in a storage location. The createStoreExtension factory can be used to create custom store extensions.

  • 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.

Learn more about styling

Container style
Item style

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

How to integrate Pintura

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.

List layout
Springyness

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.

Rik Schennink