Webflow sync, pageviews & more.
NEW

What could be causing the animated webp to not work on my Webflow website when it works perfectly in Designer Mode?

TL;DR
  • Test the animated WebP in supported browsers like Chrome or Firefox to rule out compatibility issues.
  • Use a custom Embed element with an inline <img> tag to retain animation, avoid using the Image Element.
  • Verify the source file is correctly encoded and animated outside of Webflow.
  • Rename and re-upload the file, then republish the site to bypass CDN caching.

If your animated WebP works in Webflow Designer but not on the published site, it’s likely due to browser compatibility, file handling, or asset delivery issues.

1. Browser Support Limitations

  • Safari (as of early versions) lacks full support for animated WebP. Ensure you're testing in a browser that supports animated WebP like Chrome, Firefox, or Edge.
  • Check the published site in multiple browsers to rule out compatibility issues.

2. Webflow Asset Optimization

  • Webflow may optimize or convert assets on publish, depending on their settings and purpose.
  • If your animated WebP is being added in the Image Element, Webflow may treat it as static and serve only the first frame.
  • To retain animation, always use Background Image via CSS, or embed the animated WebP using a custom Embed element with an inline <img> tag.

3. Incorrect Upload or Conversion

  • Some tools that export or convert to WebP may not encode animation correctly, or only include a single frame.
  • Recheck your source file by opening it in multiple tools like Chrome, ImageMagick, or Squoosh to verify the animation plays outside Webflow.

4. Content Delivery Network (CDN) Caching

  • Webflow’s CDN may cache an earlier version of your file without animation.
  • Force a republish: Made a small change and republish the site to clear the cache.
  • Rename the file before re-uploading to avoid CDN serving the older cached version.

5. Using the Right Method to Embed

  • Best way to retain animation:
  • Use a custom Embed and include the direct image reference:
    <img src="https://cdn.prod.website-files.com/..." loading="lazy">
  • Ensure image isn’t being auto-converted by Webflow, which can happen when dragged directly into the canvas.

Summary

If your animated WebP works in Designer but not when published, it's likely due to browser support, asset optimization, or how it was integrated. Use an Embed element for full control, test in a supported browser, and republish your site after verifying the file plays properly elsewhere.

Rate this answer

Other Webflow Questions