#1072·filepond

[Bug] Parallel use of FilePondPluginFilePoster and FilePondPluginImagePreview

Author: 463Created Jun 3, 2026Updated Aug 17, 2026
Labelsbug

Is there an existing issue for this?

  • I have searched the existing issues

Have you updated FilePond and its plugins?

  • I have updated FilePond and its plugins

Describe the bug

I like to use FilePondPluginImagePreview and FilePondPluginFilePoster in parallel to show the preview of images which can directly shown by its mime type (like .jpg) and images without direct preview opportunity (like .tif). In case two I like to set the poster by a static (or dynamic generated) poster like

pond.on('addfile', ...

    fileItem.setMetadata("poster", "/static/test.jpg");
    fileItem.setMetadata("posterType", "image");

The ImagePreview is shown as ecpected, the FilePoster is set, loaded and sized but not visible. I found out that it is explicitly set to a hidden state:

// filepond-plugin-file-poster.css

.filepond--image-preview-wrapper ~ .filepond--file-poster-wrapper {
    display: none
}

So this cannot work in general. If I reset the display: none it works properly including following automatic scaling of the preview.

Is this a feature or a bug? What is the background for hiding the FilePoster? Is there any way to operate both in parallel? Also a dynamic activation / deactivation do not work.

if (previewableTypes.includes(mimeType)) {
    // → ImagePreview
    pond.setOptions({
        allowImagePreview: true,
        allowFilePoster: false
    });
} else {
    // → Poster
    pond.setOptions({
        allowImagePreview: false,
        allowFilePoster: true
    });
}

The actual alternative is only to work with FilePoster alone or overwriting the css. What is the better solution?

Reproduction

see above

Environment

markdown
- Device:
- OS:
- Browser: