When something looks off, start here.

Likely cause

• Browser or page cache is still serving an old version of the page
• The module is switched off under Basalio > Modules
• A full-page caching plugin hasn't purged since activation

Fix

1. Hard-refresh the page (Cmd/Ctrl + Shift + R)
2. Confirm the module is toggled on in Basalio > Modules
3. Purge your caching plugin once after activation

Likely cause

• Key was pasted with a trailing space or line break
• The site URL doesn't match the one the key was issued for
• Keys take a few minutes to go live after signup

Fix

1. Retype the key instead of pasting it
2. Check Basalio > License for the exact domain on file
3. Wait a few minutes after signup, then try again

Likely cause

• The uploaded file was a GitHub source snapshot, not the built release .zip
• PHP version is below the 7.4 minimum

Fix

1. Download the release build from your beta email, not a repo download
2. Check Tools > Site Health for your PHP version and upgrade if needed

Likely cause

• An older browser isn't reporting the OS-level setting
• Custom CSS is reintroducing motion the module already disabled

Fix

1. Update to the latest version of your browser
2. Confirm the override under Basalio > Settings > Accessibility
3. Remove any custom CSS re-adding the animation

Likely cause

• A theme-wide CSS reset sets outline: none globally
• The module's focus ring color is too close to the background

Fix

1. Add a focus-visible style in your theme instead of removing outlines globally
2. Report the contrast issue so we can patch the default

Likely cause

• Several heavy modules stacked on one page
• A caching plugin isn't deferring or minifying the new script

Fix

1. Use two or three modules per page, not all nine at once
2. Set your cache plugin to defer non-critical JS, Basalio already lazy-loads its own

Likely cause

• Another plugin also declares a global with the same name
• A child theme overrides a hook that Basalio also uses

Fix

1. Disable other plugins one at a time to confirm the naming conflict
2. Compare your child theme's functions.php against the parent theme

Likely cause

• Production runs an aggressive JS combiner or minifier
• Mixed-content blocking, an asset is loading over HTTP on an HTTPS page

Fix

1. Exclude Basalio's script handle from the combiner/minifier
2. Confirm asset URLs resolve over HTTPS in Basalio > Settings

Likely cause

• Touch devices have no hover state to trigger
• A theme's own hover CSS is overriding the module with !important
• Reduced motion is enabled at the OS level, which the module respects on purpose

Fix

1. On touch, the reveal triggers on tap instead, check that first
2. Inspect the element for a competing !important rule and raise specificity
3. This is expected under reduced motion, not a bug

Likely cause

• Order is set by position in Basalio > Modules, not by placement on the page
• The same module block was placed twice on one page

Fix

1. Drag modules into the order you want inside Basalio > Modules
2. Remove the duplicate block from the page

Likely cause

• A security plugin's HTML sanitizer is stripping inline styles
• Another plugin enqueues a conflicting version of the same font

Fix

1. Whitelist Basalio's output in your security plugin's sanitizer settings
2. Disable the duplicate font enqueue in the conflicting plugin

Likely cause

• The license isn't activated on this specific site
• The beta build is already the newest version available

Fix

1. Activate under Basalio > License
2. Check the changelog, you may already be current

Likely cause

• Each activation is tied to a specific URL
• A staging-to-production move counts as a new site

Fix

1. Deactivate on the old URL first, inside Basalio > License
2. Then activate on the new ones, Studio and Agency tiers can hold both without deactivating