Help & Knowledge Base

Everything you need to know about SoundToggle — from creating your first project to advanced analytics, embeds, and troubleshooting.

Getting Started

Projects

Player & Customization

Player Layouts

SoundToggle offers 6 player layouts (plus a Video layout that activates automatically when video is present). Layout availability depends…

Color Customization

SoundToggle provides 10 color presets: Ocean Blue (default) Sunset Orange Forest Green Purple Haze Midnight Dark Coral Reef Arctic White…

Font Customization

Available on Pro and Studio plans. Choose from a library of 30+ fonts organized by category: Sans-Serif: Inter (default), Roboto, Open…

Toggle Labels

All plans can customize the labels that appear on the A/B toggle switch. Default labels are "BEFORE" and "AFTER" (or "FIRST" / "SECOND" /…

Crossfade Duration

Adjust how quickly the audio crossfades when toggling between versions. Default is 0.1 seconds (100 ms). The minimum is 5 ms for a…

Default State

Choose which version plays first when a listener loads the player — "Before" (first), "After" (second), or "Third" (if you have a three-way…

Playlist Toggle Behavior

For playlist projects, you can choose what happens to the A/B toggle when listeners move between tracks: Reset to default: The toggle…

Corner Style

Choose between two corner styles for your player: Rounded (default) — Smooth rounded corners Squared — Sharp square corners Set per-project…

Transparent Background

You can make the player's background fully transparent so it blends seamlessly into any website or embed context. Enable this on the Edit…

Branding

Free plans display SoundToggle branding on players. Pro, Studio, and Enterprise plans can remove all branding for a completely white-label…

Fast Streaming Playback

Fast Streaming (also called proxy playback) makes your player start playing almost instantly, even for large lossless files. How it works:…

Media Library

Embedding Players

Portfolio

Analytics

Plans & Pricing

Settings

Support

Troubleshooting

"Not enough storage space" error

Your total uploads have exceeded your plan's storage limit. You can either delete files from your Media Library to free up space, or…

"Maximum projects" error

Your plan has a project limit. Delete a project or upgrade to a plan with more (or unlimited) projects.

Player embed not showing on my website

Make sure the project is set to public (not private). Verify that your website platform allows custom HTML or iframe embeds. If using the…

Audio files not playing in the player

Ensure your files are in a supported format. Free plans: MP3, AAC, OGG, M4A. Paid plans: also WAV, FLAC, AIFF, ALAC. Check that files are…

Toggle switch sounds different / not seamless

Make sure your before and after files are time-aligned. Both files should be the same length and represent the same moment in the audio. If…

Portfolio page shows "Set a username" warning

You need to set a username before your portfolio is accessible. Go to Settings → Account and choose a username.

Trial expired but I can't access my dashboard

When your trial expires, a modal appears asking you to choose a plan. You must select a plan (including the free plan) to regain access.…

Embed player not resizing on mobile

Use the Responsive Embed code (not the basic iframe). The responsive embed includes JavaScript that auto-resizes the player height to match…

Can't see detailed analytics

Geographic data and device usage are available on Pro plans and above. Referral tracking, historical trends, and data export require a…

Cover art not displaying

Cover art is uploaded on the Edit Project page, not during initial project creation. Open your project for editing and add artwork there.…

"Failed to start checkout" error

This can happen due to a temporary connection issue with our payment processor (Stripe). Try again in a moment. If the problem persists,…

Can't upload WAV or FLAC files

Lossless audio uploads (WAV, FLAC, AIFF, ALAC) are available on Pro, Studio, and Enterprise plans. Free plan users can upload lossy formats…

Quality badge stuck on "Streaming"

If the quality badge in your player stays on "Streaming" and never upgrades to "Lossless," the full lossless file is still loading in the…

Proxy files not generating

If proxy files aren't being generated for your audio: Make sure Fast Streaming is enabled. Check Settings → Player Defaults → Playback →…

Tips & More

Still need help?

Our support chat is available in the bottom-right corner of your dashboard, or email us anytime.

Contact Support