Hi all,
I'm working on a portfolio page in Figma Sites and using an iframe embed to include a custom Spline scene as a visual background. The scene is published and works perfectly when opened directly via the public link: https://my.spline.design/untitled-bn0gMdBuIbeq0O9LHbaEiPj5/
- Transparent background
- Real-time effects like pixelation, chromatic aberration, vignette
- No “Built with Spline” watermark (disabled in export settings)
- Clean visuals and correct aspect ratio
But when I embed this same scene in Figma Sites using the HTML block, I run into issues.
Issues in Figma Sites iframe:
-
A white background appears, despite the canvas and scene alpha being set to transparent.
-
The Spline watermark is still visible, even though it's turned off in export.
-
Visual effects (like glow, hue shift, pixelation etc.) don’t show at all.
-
Even when using the correct embed code or hosting the scene manually with
spline.runtime.js, Figma Sites seems to render a limited or outdated version. -
Changing the URL, clearing cache (
Ctrl+Shift+R) or using versioned URLs doesn’t update the embed rendering. -
Hosting the scene on Netlify does work flawlessly, except for the lookat event, so the issue is specific to the way Figma Sites embeds and displays iframes.
What I tried:
- Used various iframe and embed configurations.
- Double-checked all canvas and export settings in Spline.
- Manually hosted a minimal transparent site using
spline.runtime.js(this version works). - Ensured pointer-events were not blocking mouse input (confirmed LookAt events still work in iframe).
- Tried setting z-index layering and fixed positioning.
- Tried to use Figma sites AI to create the wanted version for me.
My remaining question:
How can I keep the Spline embed in the background, while still allowing my mouse cursor to interact with the Spline scene, even when hovering over other HTML elements like text or buttons?
Any insights on how Figma Sites handles iframe rendering or limits embedded scripts would be appreciated. Visuals provided below:
Thanks a lot,
Mike van den Hoek
Not Afr8 Studio