Migration guide for @uploadcare/file-uploader v1.26.0
In v1.26.0, @uploadcare/file-uploader replaces Symbiote.js with LitElement internally.
What stays the same
All documented public API remains unchanged, including:
- Bundles and module formats
- Component tags and attributes
- Configuration options
- Documented events and public methods
- Public TypeScript types exposed by the package
If you use File Uploader through documented integration paths, no migration steps should be required.
What may break (undocumented API)
This release is published as a minor version, but it may still affect code that relied on internal or undocumented behavior.
Static template override (deprecated, no longer works)
Some projects used an undocumented Symbiote.js-era escape hatch to override templates:
In v1.26.0, the static template setter is deprecated and has no effect.
If you’re still overriding template, you’ll also see a warning in the browser console:
If you used this to hide the upload button in regular mode, use the headless attribute instead. See Headless mode.
Need help?
If you were relying on an internal or undocumented API and can’t migrate without it, please open an issue with a minimal reproduction and your customization goal (what you’re trying to achieve).
