How to manage subscriptions in the Dashboard

Last updated: May 5, 2026

Key fields and actions available in the Subscriptions section of the Gigs Dashboard.

Key subscription fields

Field

What it tells you

Subscription ID

Unique identifier — always include in support escalations

Status

pending, initiated, active, restricted, or ended

Plan ID

The plan the subscriber is on — links to data cap, features, and pricing

MSISDN

The phone number assigned to this subscription

ICCID

The SIM or eSIM identifier — use for SIM-level investigations

Activation date

When the subscription became active and billing started

Renewal date

The next billing date

Feature flags

Which features are provisioned: voice, SMS, data, voicemail, roaming, VoLTE, VoWiFi, hotspot

Data usage

Current cycle usage vs the plan's data cap

How to View a Subscription

  1. Navigate to Subscriptions in the left nav

  2. Search or filter by phone number, user, or status

  3. Click a subscription to view:

    • Plan, SIM, phone number, billing cycle

    • Status and lifecycle timestamps

    • Associated subscription changes and events

How To Library View.gif
You can view all subscriptions from the Subscriptions tab in the sidepane.
How To Library from User.gif
You can view any subscription associated to a User from the User object.
View Sub Statuses from How To Library.gif
You can also filter subscriptions by any status value.

How to Add a Subscription

  1. In Subscriptions, click + New Subscription

  2. Complete form:

    • User, Address, Plan, SIM (auto or specific), Start Date

  3. Click Create Subscription

  4. A webhook or Dashboard event (subscription.created) confirms activation

How to Change a Plan

  1. Open the subscription

  2. Click Actions > Change Plan or SIM

  3. Select new Plan and/or SIM, and schedule date

  4. Click Submit

  5. A subscriptionChange.pending event appears; status updates once applied

Create Plan Change.gif

How to Cancel a Subscription

  1. Open the subscription

  2. Click Actions > Cancel Subscription

  3. Choose Cancellation Reason and effective date

  4. Click Confirm

  5. A subscription.canceled event logs the cancellation

Cancel Subscription.gif

How to Resume a Subscription

  1. For subscriptions with a scheduled cancellation (status still active but set not to renew), open the subscription

  2. Click Actions > Resume Subscription

  3. Confirm or select new Start Date

  4. Click Resume

  5. A subscription.resumed event confirms the restart

Resume Sub.gif

How to Monitor Subscription Status

  • Watch Dashboard statuses: active, pending, initiated, restricted, ended

  • Use the Events tab for lifecycle context (activated, canceled, resumed, subscriptionChange)

  • For major changes, escalate if subscriptionChange stays pending or fails (check event failure codes)

image.png

This article doesn't cover:

Getting started →Getting started with the Gigs Dashboard

Reading Events →Reading the Events tab