Troubleshooting
Having issues with GrowPanel? This section covers common problems and their solutions. If you can't find an answer here, contact our support team.
Common issues
Data and sync issues
Metric discrepancies
Connection problems
Account issues
Data not syncing
Symptoms: New transactions in your billing platform aren't appearing in GrowPanel.
Possible causes and solutions:
| Cause | Solution |
|---|---|
| Webhook not configured | Set up webhooks for Chargebee or Recurly |
| Webhook URL changed | Update the webhook URL in your billing platform |
| API key revoked | Generate a new API key and update in GrowPanel |
| Rate limiting | Wait for the sync to resume (usually within an hour) |
| Data source disconnected | Reconnect the data source in Settings |
To check sync status:
- Go to Settings → Data Sources
- Check the status and "Last sync" time
- Click on the source to see detailed sync history
Missing data
Symptoms: Some customers or invoices aren't appearing in GrowPanel.
Possible causes and solutions:
| Cause | Solution |
|---|---|
| Import not complete | Wait for initial import to finish |
| API key permissions | Ensure the API key has read access to all resources |
| Filters applied | Check if a filter is hiding the data |
| Different date range | Adjust the date range in the report |
| Data source filter | Check Data Source filter if you have multiple sources |
To verify:
- Search for the specific customer in the Customers list
- Check if filters are hiding data (look for "Filtered" badge)
- Review the import progress in Data Sources
Slow import
Symptoms: Initial data import is taking many hours.
This is normal for accounts with:
- Many thousands of customers
- Years of historical data
- Millions of invoices or transactions
What's happening:
- GrowPanel fetches all historical data
- Billing platforms have rate limits
- Large accounts are processed in batches
What to do:
- Let the import continue - you'll receive an email when complete
- Check progress in Settings → Data Sources
- You can start using GrowPanel with partial data while import continues
Estimated times:
| Account size | Estimated import time |
|---|---|
| < 1,000 customers | Minutes |
| 1,000-10,000 customers | 1-2 hours |
| 10,000-100,000 customers | 2-8 hours |
| > 100,000 customers | 8+ hours |
Duplicate data
Symptoms: Same customer or transaction appears multiple times.
Possible causes and solutions:
| Cause | Solution |
|---|---|
| Multiple data sources | Use Data Source filter to view one source at a time |
| Webhook replay | GrowPanel handles duplicates - should resolve automatically |
| Test mode mixed with live | Ensure you're only connected to production/live accounts |
Note: If you connect both a Stripe test account and live account, you may see test data mixed with real data. Remove the test connection if not needed.
MRR doesn't match billing platform
Symptoms: GrowPanel's MRR is different from your billing platform's dashboard.
Common reasons for differences:
| Reason | Explanation |
|---|---|
| Calculation timing | GrowPanel uses end-of-day snapshots; your billing platform may show real-time |
| Trial handling | GrowPanel may exclude trials from MRR; some platforms include them |
| Currency conversion | Different exchange rates or conversion timing |
| Pending invoices | GrowPanel counts paid invoices; pending charges may differ |
| Metered billing | Usage-based charges may be calculated differently |
| Churn timing | GrowPanel's churn recognition setting affects when churn appears |
To investigate:
- Export both reports for the same date range
- Compare at the customer level
- Check reporting currency settings
- Review churn recognition setting in Settings → Reporting
See Understanding MRR differences for detailed explanation.
Churn numbers seem wrong
Symptoms: Churn rate or churned MRR doesn't match expectations.
Check these settings:
Churn recognition timing (Settings → Reporting)
- "Immediate" counts churn when canceled
- "End of period" counts churn when subscription ends
Auto-churn past-due setting
- Customers past-due beyond this threshold are counted as churned
Date range
- Ensure you're viewing the correct period
Common misunderstandings:
| Situation | GrowPanel behavior |
|---|---|
| Customer cancels mid-month | Churn is recognized based on your settings |
| Customer downgrades to free | Counted as churn (MRR goes to zero) |
| Customer switches plans | May show as contraction, not churn |
| Failed payment | Counted as churn after auto-churn threshold |
Currency conversion issues
Symptoms: Revenue numbers in reports don't match expected conversions.
How GrowPanel handles currency:
- Multi-currency revenue is converted to your reporting currency
- Daily historical exchange rates are used
- You can optionally fix rates at a specific date
To troubleshoot:
- Check your default reporting currency in Settings → Reporting
- Use the currency filter to view a specific currency
- Enable "Fix exchange rate" to remove FX fluctuations
- Compare individual transactions in the customer detail page
Can't connect data source
Symptoms: Error when trying to add Stripe, Chargebee, or Recurly.
For Stripe (OAuth):
| Error | Solution |
|---|---|
| "Access denied" | Ensure you have admin access to the Stripe account |
| "Invalid account" | Verify you're connecting the correct Stripe account |
| Redirect loop | Clear browser cookies and try again |
For Chargebee/Recurly (API key):
| Error | Solution |
|---|---|
| "Invalid API key" | Verify the key is correct and has read access |
| "Site not found" | Check the subdomain/site name is correct |
| "Permission denied" | Ensure the API key has full read-only access |
Stripe OAuth errors
Symptoms: Error during Stripe connection or disconnected unexpectedly.
Common issues:
| Issue | Solution |
|---|---|
| "This account is already connected" | The Stripe account is linked to another GrowPanel account |
| Connection keeps disconnecting | Check if another admin revoked access in Stripe |
| Can't select the right account | Clear cookies or use incognito mode |
To reconnect:
- Go to Settings → Data Sources
- Remove the existing Stripe connection
- Click Add Data Source → Stripe
- Complete the OAuth flow again
Webhook failures
Symptoms: Data source shows webhook errors; real-time sync not working.
To troubleshoot:
- Check webhook logs in your billing platform (Chargebee/Recurly)
- Verify the webhook URL matches what's shown in GrowPanel
- Ensure the webhook isn't disabled
- Test the webhook from your billing platform
Common fixes:
- Re-copy the webhook URL from GrowPanel
- Delete and recreate the webhook
- Verify no firewall is blocking GrowPanel's IP addresses
Can't sign in
Symptoms: Unable to access your GrowPanel account.
| Issue | Solution |
|---|---|
| Forgot password | Click "Forgot password" and check your email |
| Wrong email | Try other email addresses you might have used |
| Google/Microsoft sign-in fails | Try the email/password option if you set one |
| "Account not found" | Check you're on the correct GrowPanel URL |
| Locked out | Contact support for account recovery |
Not receiving emails
Symptoms: No notification emails, scheduled reports, or password resets.
Check:
- Your spam/junk folder
- That emails from growpanel.io aren't blocked
- Your email address in Account → Profile
- Notification settings in Settings → Notifications
Add to safe senders:
Understanding MRR differences
GrowPanel calculates MRR based on invoices, which may differ from your billing platform's real-time view.
GrowPanel's approach:
- Imports all invoices from your billing source
- Calculates MRR from subscription invoices
- Normalizes to monthly (annual plans divided by 12)
- Converts to reporting currency using daily rates
This may cause differences with:
- Real-time dashboard in Stripe/Chargebee/Recurly
- Platforms that use different MRR definitions
- Reports that include pending/draft invoices
For the most accurate comparison:
- Export customer-level data from both systems
- Reconcile on a per-customer basis
- Check calculation methodology in both platforms
Still need help?
If you can't resolve your issue:
- Email support: [email protected]
- Include:
- Your account email
- Description of the issue
- Screenshots if applicable
- Steps you've already tried
We typically respond within 24 hours on business days.