Reference

Troubleshooting, quick fixes.

The 90% of issues that come up, with a one-paragraph fix for each. If yours isn’t here, the contact link at the end gets a real human.

Animation isn't appearing on the live site

Almost always one of three things:

  • Browser cache. Hard refresh (Ctrl+Shift+R / Cmd+Shift+R). Bundles push to the CDN within seconds, but your browser may hold the previous one for a minute.
  • You saved on a different page. Animations are scoped per page. Open the sidebar on the page in question and confirm the animation is listed there.
  • Trial license.Trial saves don’t push to the CDN. The Save button shows Saved (trial) when this is the case. Activate a paid plan to publish.

Brief flash before the animation runs

Elements appear at their natural state for a moment, then jump to the animation start. This is FOUC, flash of unstyled content.

  • On WordPress and plain HTML, the anti-FOUC stylesheet is bundled into the script. If you’re seeing FOUC, the script is loading too late. Make sure the Glopzi script tag is in the <head>, not at the end of the body.
  • On Next.js, Astro, Remix, SvelteKit, you need the separate <link rel="stylesheet"> tag in addition to the script. See Next.js (or your framework’s integration page) for the exact pattern.
  • On any stack, third-party scripts that block render (chat widgets, analytics) can delay our stylesheet. Move them to load asynchronously if possible.

Selector matches zero elements

The match counter in the right panel shows red. Common causes:

  • The element only exists on another route. The animation is scoped to the page you’re currently editing. Switch to the page where the element lives, or accept that this animation won’t fire on this route.
  • Your builder regenerated the class. If the selector starts with a generated identifier, your builder may have rebundled. Re-pick the element, then secure the target so it survives next time.
  • The element is conditional.Some templates show elements only when logged in, only on certain dates, etc. Glopzi can’t animate what doesn’t render.

Wrong element is animating

The match counter is yellow (multiple matches) and a sibling moves instead of (or in addition to) the one you intended.

  • Use the picker again with Alt held. The Alt-bypass forces the picker to grab the leaf element, often what you wanted. See Picking an element.
  • Tighten the selector manually. In the target chip, change the selector to scope it more specifically. For example, .hero .cta instead of just .cta.
  • Secure the target. A Glopzi ID makes the animation point at exactly one element regardless of selector ambiguity.

Smooth scroll feels jittery

Lenis-powered smooth scroll can occasionally show microframes of drift on elements with position: fixedwhen scrolling aggressively. The browser’s own asynchronous scroll is the underlying cause; every smooth-scroll library has this issue.

  • If the glitch is on a specific element, check whether it’s using position: fixed and whether you need it to be. Sticky positioning is often a better fit and avoids the glitch.
  • If you don’t care for smooth scroll, disable it from the toolbar toggle. Native scroll has no asynchrony issue.

Save fails or hangs

  • Hangs at “Saving” for 30+ seconds: check your network. If your network is fine, our status page (link in dashboard) will indicate any outage on our end.
  • Fails with a license error: open the License keys page for activation troubleshooting.
  • Fails with a domain error: the site you’re editing isn’t in your bound domains. See Adding and managing domains.
  • Save succeeded but live site doesn’t update: hard refresh, then wait a minute.

Editor frame is blank

The editor loaded, the toolbar is there, but the canvas shows nothing.

  • Iframe blocked. Some hosts set X-Frame-Options: DENY by default. Open the browser console; if you see an X-Frame-Options error, contact your host or open a support ticket through our contact page.
  • Behind login or staging firewall. The editor needs to reach your page. If your site requires authentication, sign in in the same browser first, then open the editor.
  • Content Security Policy. If your CSP includes a strict frame-ancestors directive, add https://studio.glopzi.com to the allowed list.

Still stuck

We reply within 2 business days. Reach us through our contact page with:

  • The URL of the page you’re trying to animate.
  • What you expected and what you’re seeing.
  • Any error from the browser console (open dev tools, screenshot the Console tab).
  • The browser and operating system.

Tip

For account or billing issues, the Account and billing section often has the answer faster than support.