Skip to content
  • There are no suggestions because the search field is empty.

Tracking Script Version Management

Gain full control over your tracking script updates with Convert’s versioning system that supports manual, automatic, and scheduled options.

🚀 IN THIS ARTICLE YOU WILL:

📊  OVERVIEW

With Convert’s Tracking Script Versioning feature, you gain full control over how and when the tracking script is updated across your projects—ensuring stability, flexibility, and improved transparency.


🔒 This feature is only available for accounts using the new tracking script. If you're using the legacy script, versioning options will be disabled.

🔍 What Is It?

Convert now supports versioning for the tracking script, allowing you to:

  • Stay on a stable version if needed
  • Auto-upgrade to the latest improvements
  • Schedule future upgrades
  • Roll back to the previous version (Manual mode only)

This feature is available at both:

  • Account level (default settings for all projects)
  • Project level (for individual project overrides)

🧭 Where to Find It

You’ll find Tracking Script Versioning in two places:

  1. Account Settings > Tracking Script Version
    01-TrackingVersion
Project Settings > Configuration > Environments & Tracking Code Tab
02-TrackingVersion

⚙️ Release Types Explained

When choosing how to manage updates, you can select from the following release types via dropdown:

1. Manual (default)

  • You choose when to upgrade to a newer script version.
  • See the current version and all available versions.
  • A "Rollback" option is available — but only to the immediate previous version.
    03-TrackingVersion
  • Upgrade prompts show a changelog (e.g. bug fixes, enhancements).
  • Only admins or account owners can manage versions. 04-TrackingVersion

2. Automatic

  • Your tracking script is upgraded automatically as soon as a new version is released.
  • You’ll still see which version you're currently on.
  • Great for staying up-to-date without lifting a finger. 05-TrackingVersion

3. Scheduled

  • Set a specific day of the week and time (e.g., Monday at 3:00 AM).
  • Automatically applies new versions according to your schedule.
  • You can adjust this schedule at any time.
  • Each available version will display the next planned update time. 06-TrackingVersion

🔄 Rollback Behavior (Manual Only)

You can roll back to your previous version only. Example:

  • If you're on v3.0, and upgrade to v3.11, you can roll back to v3.0.
  • Once you move to v4.0, you cannot go back to v3.0—only v3.11 (the most recent version before v4.0).

This is to maintain integrity and ensure consistent performance across updates.

🛎️ Update Notifications

When a new version is released:

  • Users on Manual will see a blue information icon notification.
  • Clicking the notification takes you directly to the tracking script tab with version details.
  • Notifications persist until acknowledged.
  • If dismissed, it reappears after 7 days (for Manual type only).

For Scheduled or Automatic, the notification is informative only:

  • “See what’s new” but no manual update action.
  • Encouraged to test new version in pre-production/staging.

👉 Sample Notification Messages

  • Manual: “A new version (v2.12) is now available! See what's new & Upgrade.”
  • Automatic: “A new version (v2.12) is now available! See what’s new.”
  • Scheduled: “A new version (v2.12) is now available! See what’s new.”

💡 Best Practices

  • Use Manual if your setup is sensitive to changes and you need full control.
  • Use Scheduled if you prefer stability but want regular upgrades.
  • Use Automatic if you're confident with Convert’s release reliability.

⚠️ Limitations & Notes

  • This feature is not available for Fullstack projects (they don’t use browser tracking scripts).
  • Projects using the Legacy Script will see this section as locked.
  • Available only for accounts with the advanced_tracking_script_release feature flag.

If your account doesn’t have this, only Automatic will be selectable. Manual and Scheduled will appear locked with an upgrade suggestion.

 

💬 FAQs

Q: Can I apply the same version to multiple projects from the account level?
 A: Yes, if those projects use the Manual release type. You'll be able to apply a version across selected projects.

Q: Will I lose my settings if I change release type?
 A: No. Your current script remains unchanged until a version change is applied manually or via schedule.

Q: Will the changelog show benefits of each version?
 A: Yes. Example:

  • Bug fixes
  • Improved SPA support
  • Case-sensitive domain fixes