🍀How to add a GSAP animation

Add GSAP animations to your Webstudio site with custom code.

Embed GSAP library on the page

1. Add HTML Embed Component to the canvas

2. Activate "Client Only" setting

3. Optionally activate "Run script on canvas" setting

4. Open GSAP official installation instruction

5. Copy the scripts into HTML Embed Code in Settings

Example

<script defer src="https://cdn.jsdelivr.net/npm/gsap@3.12.5/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3.12.5/dist/Flip.min.js"></script>
<script type="module">
  gsap.registerPlugin(Flip);
  gsap.fromTo(".animation", {opacity: 0}, {
    opacity: 1, 
    duration: 1, 
    stagger: 0.1, 
    ease: "power2.inOut"
  });  
</script>

Q&A

How to reuse the animation on multiple pages?

You can reuse the animation using Slot component

Can I use the Custom Code from project settings to include GSAP on all pages?

While you can add the library in the HEAD in project settings, this HTML won't run in preview, so you can't test inside the builder. Additionally, if you use async or defer attributes, there is no guarantee that your HTML Embed scripts on the page won't run before the library is loaded. If you don't use defer or async attributes, you will slow down your site by blocking the rendering until the library is loaded.

Identifier 'x' has already been declared

Learn more about script scope here.

Demo

Preview Link Builder Link

Related

• Animations – Built-in animation capabilities in Webstudio

• HTML Embed – Add custom scripts and code to your pages

• Project settings – Add global scripts in the custom code section

• Variables – Use variables for dynamic animation values