# Troubleshooting

Solutions to common issues and problems you might encounter while using UpReport.

## Common Issues

### 🚫 Status Page Not Loading
Your status page isn't accessible or shows errors.

#### Possible Solutions:
- Check if your subdomain is correctly configured
- Verify custom domain DNS settings (if using custom domain)
- Clear your browser cache and try again
- Check your organization's status page settings
- Contact support if the issue persists

### 📧 Notifications Not Sending
Subscribers aren't receiving incident or maintenance notifications.

#### Troubleshooting Steps:
- Verify your notification settings are enabled
- Check if you've exceeded your plan's notification limits
- Ensure email templates are properly configured
- Test with a sample notification
- Check subscriber email addresses for bounces
- Verify your email provider's delivery settings

### 🔑 API Authentication Issues
Getting 401 Unauthorized errors when using the API.

#### Check These Items:
- Ensure your API token is valid and not expired
- Verify the Authorization header format: `Bearer your_token`
- Check that your token has the required permissions
- Regenerate your API token if necessary
- Ensure you're using the correct organization ID

### 🔄 Component Status Not Updating
Components show incorrect status or don't update automatically.

#### Resolution Steps:
- Verify external monitoring integrations are working
- Check if manual overrides are in place
- Review webhook configurations and endpoints
- Test API calls for status updates
- Ensure component monitoring is enabled
- Check for any recent configuration changes

## Performance Issues

### 🐌 Slow Status Page Loading
- Optimize images and logos
- Reduce number of components if excessive
- Check your internet connection
- Try accessing from different locations
- Contact support for performance analysis

### ⏱️ Dashboard Responsiveness
- Clear browser cache and cookies
- Update to the latest browser version
- Disable browser extensions temporarily
- Check for JavaScript errors in console
- Try using an incognito/private window

## Integration Problems

### Slack Integration Issues

#### Common Problems & Solutions:

##### Messages not appearing in Slack
- Verify the UpReport app is installed in your workspace
- Check channel permissions for the UpReport bot
- Ensure notification rules are configured correctly

##### Authentication errors
- Reconnect the Slack integration
- Check if workspace admin approval is required
- Verify OAuth permissions are granted

### Webhook Configuration

#### Webhook Debugging:

##### Webhooks not triggering
- Verify your endpoint URL is accessible
- Check firewall settings for incoming requests
- Ensure your endpoint returns 200 status code
- Review webhook event filters

##### Payload validation errors
- Verify webhook signature validation
- Check Content-Type header handling
- Review payload structure in documentation

## Account & Billing

### 📊 Plan Limits Reached
What to do when you hit plan limitations:
- Check current usage in billing section
- Upgrade to a higher plan if needed
- Optimize component and check usage
- Remove unused integrations
- Contact sales for enterprise options

### 💳 Payment Problems
Resolving billing and payment issues:
- Update expired payment methods
- Check billing email for failed payments
- Verify billing address information
- Contact support for payment assistance
- Review invoice history for discrepancies

## Getting Additional Help

### Can't Find a Solution?

#### 📧 Contact Support
Our support team is here to help with technical issues and questions.

#### 📚 Documentation
Explore our comprehensive help center for detailed guides.

#### 💡 Before Contacting Support
Please include the following information to help us assist you faster:
- Your organization subdomain or ID
- Detailed description of the issue
- Steps to reproduce the problem
- Browser/device information (if applicable)
- Screenshots or error messages