Skip to main content

Track

Track conversion signals when users hit limits, access blocked features, or show upgrade intent.

Basic Usage​

upsell.track('limit_reached', {
  feature: 'projects',
  current: 5,
  limit: 5
})

Parameters​

ParameterTypeRequiredDescription
eventNamestringYesName of the event
propertiesobjectNoAdditional event data

Common Events​

limit_reached​

Track when a user hits a usage limit:

upsell.track('limit_reached', {
  feature: 'projects',
  current: 5,
  limit: 5
})

upsell.track('limit_reached', {
  feature: 'api_calls',
  current: 1000,
  limit: 1000
})

feature_blocked​

Track when a user tries to access a premium feature:

upsell.track('feature_blocked', {
  feature: 'analytics'
})

upsell.track('feature_blocked', {
  feature: 'advanced_reporting'
})

trial_warning​

Track when a trial is ending:

upsell.track('trial_warning', {
  daysLeft: 3
})

pricing_viewed​

Track when a user views pricing:

upsell.track('pricing_viewed', {
  source: 'upgrade_modal'
})

Custom Events​

You can track any custom event:

upsell.track('export_attempted', {
  format: 'csv',
  rowCount: 10000
})

upsell.track('team_member_invited', {
  currentMembers: 5,
  limit: 5
})

HubSpot Integration​

Tracked events update the associated HubSpot contact:

  • upsellsdk_last_event - Event name
  • upsellsdk_last_event_at - Timestamp
  • upsellsdk_upgrade_intent - Calculated intent score