Skip to main content
Get started with sptfy.in in four simple steps. No account required.
1

Visit sptfy.in

Open sptfy.in in your browser.You’ll see a clean interface with a URL input field and a “paste” button.
2

Paste Your Spotify URL

Copy any Spotify link from the Spotify app or web player:
https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT?si=abc123def456
Then either:
  • Click the paste button (clipboard icon)
  • Or manually paste into the input field
sptfy.in automatically detects and extracts Spotify URLs from clipboard content.
spotify.link URLs: If you paste a spotify.link short URL, sptfy.in will automatically expand it to the full Spotify URL before processing.
3

Click 'short It!'

Once your URL is in the input field, click the green short It! button.The button will show:
  • validating... - Cloudflare Turnstile is verifying you’re human
  • loading... - Your link is being created
  • Success 🥳 - Your short link is ready!
The button may say validating... while Cloudflare Turnstile checks for bots. This typically completes in 1-2 seconds.
4

Copy & Share

Your shortened link appears in the right panel:
sptfy.in/a1b2
Click the copy button to copy it to your clipboard, or click the open button to test it.URL preview panel
Want a memorable URL instead of a random one? Use custom slugs.
  1. Click customize below the URL input field
  2. Choose a domain (optional):
    • sptfy.in (default)
    • artist.sptfy.in
    • playlist.sptfy.in
    • track.sptfy.in
    • profile.sptfy.in
  3. Type your custom slug (minimum 4 characters)
sptfy.in/my-favorite-jazz
The slug field shows real-time validation:
  • 🟢 Green border = Available
  • 🟡 Yellow border = Checking…
  • 🔴 Red border = Taken or invalid
Custom slugs are automatically sanitized:
  • Converted to lowercase
  • Special characters replaced with hyphens
  • Leading/trailing hyphens removed
Some slugs are reserved for sptfy.in system pages and cannot be used:
  • recent, top, about, terms, privacy
  • login, prev, dash, debug, api, admin
If you try to use a reserved slug, you’ll see an error.
Custom slugs must:
  • Be at least 4 characters long
  • Contain only letters, numbers, hyphens, and underscores
  • Not exceed 80 characters
  • Be unique (not already taken)
Examples:
  • my-playlist
  • jazz_2024
  • workout-mix
  • abc (too short)
  • my playlist (spaces not allowed)
  • recent (reserved)
Every shortened link comes with built-in click tracking.
1

Click 'Show Clicks'

After creating a link, click the Show Clicks button in the URL preview panel.
2

View Analytics Dashboard

You’ll see:
  • Total click count
  • Click history with timestamps
  • Geographic data (coming soon)
  • Bot detection status
Analytics are public by default. Anyone with the link can view click stats by adding /s to the URL: sptfy.in/a1b2/s

Generate QR Codes

Share your Spotify links offline with QR codes.
1

Click 'Show QR'

After creating a link, click the Show QR button in the URL preview panel.
2

Download or Share

A QR code is generated automatically. You can:
  • Download the QR code as a PNG image
  • Scan it directly with your phone to test
QR codes are generated dynamically and always point to your shortened URL.
sptfy.in accepts all Spotify content URLs:

Tracks

open.spotify.com/track/...

Albums

open.spotify.com/album/...

Playlists

open.spotify.com/playlist/...

Artists

open.spotify.com/artist/...

What Happens Behind the Scenes

When you shorten a link, here’s what sptfy.in does:
1

URL Validation

The URL is checked to ensure it’s a valid Spotify URL. Only open.spotify.com and spotify.link URLs are accepted.
// From src/lib/utils.js
const spotifyUrlPattern = /https:\/\/open\.spotify\.com\/(track|album|playlist|artist|show|episode)\/[a-zA-Z0-9]+/;
2

Bot Detection

Cloudflare Turnstile verifies you’re human (not a bot). This happens automatically in the background.
// From src/routes/+page.svelte
<Turnstile
  siteKey={turnstileKey}
  theme="dark"
  appearance="interaction-only"
  on:callback={(event) => {
    turnstileResponse = event.detail.token;
  }}
/>
3

Slug Generation or Validation

If you provided a custom slug, sptfy.in checks if it’s available. Otherwise, it generates a random 4-character slug.
// From src/lib/pocketbase.js
const alphabet = '0123456789abcdefghijklmnopqrstuvwxyz';
const generateNanoId = customAlphabet(alphabet, 4);
4

Database Storage

The mapping (short slug → Spotify URL) is saved to PocketBase.
// From src/routes/api/links/+server.js
const data = {
  from: spotifyUrl,
  id_url: slug,
  subdomain: 'sptfy.in',
  enable: true
};
await pb.collection('random_short').create(data);

Next Steps

Now that you’ve created your first short link, explore more features:

Manage Your Links

Learn how to view, edit, and delete your links with an account.

Deep Dive into Analytics

Understand click tracking, bot detection, and export options.

API Integration

Automate link creation with the sptfy.in API.

Self-Host sptfy.in

Deploy your own instance for full control and privacy.

Troubleshooting

This error appears if you click the paste button but your clipboard doesn’t contain a Spotify URL.Solution: Copy a Spotify link first, then click paste. Or manually paste the URL into the input field.
The button may stay on validating... if Cloudflare Turnstile fails to load or verify.Solutions:
  • Wait a few seconds—Turnstile usually completes automatically
  • Check your ad blocker settings (some block Turnstile)
  • Refresh the page and try again
Your custom slug is already in use by another link.Solution: Choose a different slug. The input field shows real-time availability as you type.
You’ve created too many links in a short time period.Solution: Wait a few minutes before creating more links. Rate limits reset automatically.
Need more help? Check the GitHub Issues or visit the status page for service updates.

Build docs developers (and LLMs) love