🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

⚠️ Not breaking but please test your plausible integration after updating.

Plausible introduced a new script format in October 2025 with unique per-site script IDs and plausible.init() for configuration instead of script extensions.

1. Unique Script IDs: Each site now gets a unique script ID (found in Site Installation settings)
2. No more extensions: Configuration is done via plausible.init() options instead of script extensions
3. Simplified setup: Custom events, revenue tracking, and form submissions are now automatically available

We support the legacy usage of the script however it is now deprecated and users should migrate.

Migration Guide

Old format (domain + extensions):

useScriptPlausibleAnalytics({
  domain: 'example.com',
  extension: ['hash', 'outbound-links']
})

New format (scriptId + init options):

useScriptPlausibleAnalytics({
  scriptId: 'YOUR_SCRIPT_ID', // Get from Plausible dashboard
  hashBasedRouting: true,
  // outbound-links is now enabled by default
})