All Collections
Best Practices, Tips & Tricks
Tips & Tricks
Apply seasonal effects to your Flipbooks with Custom Scripting!
Apply seasonal effects to your Flipbooks with Custom Scripting!

Create immersive and fun seasonal effects to enhance your seasonal catalogs with this Custom Scripting feature.

Updated over a week ago

If your business makes use of seasonal promotions, you likely already create Flipbooks that cater specifically to them. Did you know that you can enhance your seasonal catalogs by creating fun, and immersive, on-screen effects?

That's right – you can add audio and visual cues to your Flipbook using Custom Scripting. Take a look:

👀 Experience this seasonal effect in one of our live Flipbooks:

📖 This guide explains:

What is Custom Scripting?

Custom Scripting is a feature that allows you to inject third party scripts into your Flipbook. Specifically, this feature allows you to add non-native scripts into the header and footer tags around your Flipbook.

You can read more about Custom Scripting works in iPaper, in our guide:

Enabling Custom Scripting on your account

Custom Scripting is enabled on the account level, rather than for individual Flipbooks, or folders. This means that, once enabled, you'll be able to inject custom scripts into any of your Flipbooks.

⚠️ Custom scripting is available on all iPaper accounts, but can only be accessed by account Administrators. If you’re unsure who your account administrator is, you can easily find out, using this method.

You can find a detailed walkthrough of how to enable Custom Scripting on your iPaper account, as an administrator, here:


How to set up the seasonal catalog effects

The snowfall effect ❄️

This guide shows you how to create a dynamic floating button that toggles:

  • an audio track

  • a visual, snowfall effect

⚠️ We recommend avoiding changing much of the code unless you have experience with JavaScript. As this is a third-party script, iPaper does not support, nor can guarantee that scripts will work as intended.

Putting the script into your Flipbook

This custom script draws on assets, such as the image that will form the floating button, and the audio track that will play when toggled.

Simply copy the script below, and paste it into the Scripts field in Custom Scripting:

<script src="https://viewer.ipaper.io/ViewFile1700200.js"></script>

<script>
// Define the URL for the "Effect Off" icon
var iconOFF = 'https://viewer.ipaper.io/ViewFile1699866.svg';

// Define the URL for the "Effect On" icon
var iconON = 'https://viewer.ipaper.io/ViewFile1699865.svg';

// Specify the URL for the background music
var soundURL = 'https://viewer.ipaper.io/ViewFile1687063.mp3';

// Set the autoStart option (true to enable, false to disable)
// Enabling this option will disable the Call to Action (CTA) and background music
var autoStartSnowFall = false;

</script>

For this seasonal effect, we've hosted the assets on the iPaper server, meaning you can draw from them without having to upload your own. However, if you would like to change the visual, or audio assets, you will need to provide these yourself, and edit the Configuration settings in the script.

Configuring the script with your own audio and visual assets

You can choose to host these assets anywhere you have access to, including on a server external to iPaper, but we recommend uploading your assets to your Media Library. Once uploaded, you'll want to use the file destinations to customize your seasonal catalog effect.

⚠️ We recommend avoiding changing much of the code unless you have experience with JavaScript. As this is a third-party script, iPaper does not support, nor can guarantee that scripts will work as intended.

There are a number of customizations you can apply to the script, by changing the values of:

  • Define the URL for the "Effect Off" icon var iconOFF =⁣ – this defines the image displayed when the seasonal effect is toggled OFF. To change this, enter the URL of your desired image between the ' ' marks.

  • Define the URL for the "Effect On" icon var iconON = – this defines the image displayed when the seasonal effect is toggled ON. To change this, enter the URL of your desired image between the ' ' marks.

  • Specify the URL for the background music var soundURL = – this defines the audio that plays when the script is toggled ON. To change this, enter the URL of your desired audio track between the ' ' marks.

  • var autoStartSnowFall = false; – Enabling this option to TRUE will:

    • disable the Call to Action (CTA) and background music

    • enable the snowfall effect to start automatically when a visitor lands on your Flipbook. The effect is untoggleable, meaning they cannot stop, or restart it.

Once you've pasted in your code and saved your changes, the seasonal effect will be live on your Flipbook!


The love hearts effect 💕

Putting the script into your Flipbook

This custom script draws on assets, such as the image that will form the floating button, and the audio track that will play when toggled.

Simply copy the script below, and paste it into the Scripts field in Custom Scripting:

<script src="https://cdn.jsdelivr.net/npm/tsparticles@2.9.3/tsparticles.bundle.min.js"></script> 

<script src="https://cdn.jsdelivr.net/npm/tsparticles-shape-heart@2.9.3/tsparticles.shape.heart.min.js"></script>

<script src="https://viewer.ipaper.io/ViewFile1762423.js"></script>

Remember to save your changes, and then you're done! Your Flipbook will now show with a cute, floating hearts effect.

Enhance your seasonal catalog even more with a background

You've already given your Flipbook visitors an extra, immersive experience, with this seasonal effect, so why not further enhance it by applying a themed background to your Flipbook?

Read more on how to apply backgrounds to your Flipbook, below:

⚠️ Background images offer an extra, immersive layer for visitors browsing your Flipbook via a desktop browser. As such, please note that background images are not visible on mobile browsers.

Of course, if you're unsure about any of the steps above, reach out to us using the Messenger in the corner, and we'll be happy to help! ⛄

Did this answer your question?