Skip to main content

Managing Tenants

Tenants are your customers โ€” the businesses that use FeedbackPulse to collect feedback.


๐Ÿ“‹ Tenant List (/admin/tenants)โ€‹

The tenant list shows all registered accounts with:

  • Company name and slug
  • Current plan
  • Status badge (Active, Trial, Suspended, Cancelled)
  • Registration date
  • Submission count

Filteringโ€‹

Use the filter tabs to view:

  • All โ€” every tenant
  • Active โ€” tenants with paid subscriptions
  • Trial โ€” tenants in free trial
  • Suspended โ€” manually suspended tenants
  • Inactive โ€” cancelled or expired

Searchingโ€‹

Use the search bar to find tenants by company name, email, or slug.


๐Ÿ“„ Tenant Detail Page (/admin/tenants/{id})โ€‹

Click on any tenant to see their full profile:

Account Informationโ€‹

  • Company name, slug, subdomain
  • Admin email
  • Registration date
  • Current status

Subscription Detailsโ€‹

  • Current plan name and pricing
  • Payment gateway (Stripe/PayPal)
  • Subscription start date
  • Expiration date
  • Trial end date

Usage Statisticsโ€‹

  • Products count (vs. plan limit)
  • Campaigns count (vs. plan limit)
  • Submissions this month (vs. plan limit)
  • Team members (vs. plan limit)

Team Membersโ€‹

  • List of all users in the tenant account
  • Their roles (admin/staff)

โš™๏ธ Tenant Actionsโ€‹

Suspend a Tenantโ€‹

Temporarily blocks the tenant from accessing their dashboard. Their public pages are also disabled.

When to use: Non-payment, ToS violation, abuse.

Activate a Tenantโ€‹

Restores access for a suspended tenant.

Delete a Tenantโ€‹

Permanently removes the tenant and all their data (products, campaigns, submissions, team members). This uses soft delete โ€” the data is marked as deleted but can be recovered from the database if needed.

โš ๏ธ Warning: Deleting a tenant removes all their data. This cannot be undone from the admin panel.

Impersonate a Tenantโ€‹

See the platform from the tenant's perspective. Useful for debugging issues or providing support.

  1. Click Impersonate on the tenant detail page
  2. You're now logged in as the tenant's admin
  3. A banner appears at the top: "You are impersonating [Tenant]"
  4. Click Stop Impersonating to return to your superadmin session

๐Ÿ”’ Security: Impersonation sessions auto-expire after 60 minutes. All actions during impersonation are logged in the audit trail.


๐Ÿ”„ Tenant Statusesโ€‹

StatusDescriptionCan Access Dashboard?Public Pages Active?
trialIn free trial periodโœ… Yesโœ… Yes
activePaid subscription activeโœ… Yesโœ… Yes
suspendedManually suspended by adminโŒ NoโŒ No
restrictedTrial expired, no paid planโš ๏ธ Limitedโš ๏ธ Limited
cancelledSubscription cancelledโŒ NoโŒ No

โญ๏ธ Next Stepsโ€‹