Skip to content

Troubleshooting Guide

This guide provides solutions to common issues you might encounter when using Carbon GPT. If you can't find a solution to your specific problem, please contact our support team.

Data Collection Issues

Missing or Incomplete Data

Issue: Data appears to be missing or incomplete in your emissions calculations.

Solutions:

  1. Check data request status in the Data Request dashboard
  2. Verify that all required fields are completed in data entry forms
  3. Check for validation errors in the data quality report
  4. Ensure all relevant data sources are connected and active
  5. Verify that the correct date range is selected for your analysis

Data Import Failures

Issue: Unable to import data from files or external systems.

Solutions:

  1. Verify that your file is in the correct format (CSV, Excel, etc.)
  2. Check that column headers match the expected format
  3. Ensure the file size is within the allowed limits
  4. Check for special characters or formatting issues in your data

Emission Factor Errors

Issue: Emission calculations show errors related to emission factors.

Solutions:

  1. Verify that appropriate emission factors are selected for your activities
  2. Check if emission factors are up-to-date
  3. Ensure activity data units match the emission factor units
  4. For custom emission factors, verify the values and documentation
  5. Check if the emission factor is applicable to your geographic region

Calculation Issues

Unexpected Calculation Results

Issue: Emissions calculations produce unexpected or seemingly incorrect results.

Solutions:

  1. Verify input data accuracy and units
  2. Check the calculation methodology selected
  3. Review any custom calculation parameters
  4. Compare with previous periods to identify anomalies
  5. Check for data outliers that might be skewing results

Scope Allocation Problems

Issue: Emissions are being allocated to the wrong scope.

Solutions:

  1. Review your organizational boundaries definition
  2. Check the emission source categorization
  3. Verify ownership and operational control settings
  4. Ensure correct application of market-based vs. location-based methods for Scope 2
  5. Review any custom scope allocation rules

Calculation Timeout Errors

Issue: Calculations time out or fail to complete for large datasets.

Solutions:

  1. Break down calculations into smaller batches
  2. Optimize data by removing unnecessary detail
  3. Schedule calculations during off-peak hours
  4. Check for circular references in custom calculations
  5. Contact support to increase processing capacity (Enterprise plans)

Reporting Issues

Report Generation Failures

Issue: Unable to generate or export reports.

Solutions:

  1. Verify that all required data is available for the reporting period
  2. Check for validation errors in the underlying data
  3. Ensure the report template is correctly configured
  4. Try generating the report in a different format
  5. Check browser compatibility if using export functions

Visualization Problems

Issue: Charts or graphs are not displaying correctly.

Solutions:

  1. Clear browser cache and reload the page
  2. Try a different browser
  3. Check that data ranges are appropriate for the visualization type
  4. Verify that all required data points are available
  5. Adjust time periods or aggregation settings

PDF Export Issues

Issue: PDF exports are formatted incorrectly or missing data.

Solutions:

  1. Check that all visualizations have fully loaded before export
  2. Try reducing the complexity of the report
  3. Ensure custom branding elements are in the correct format
  4. Try exporting in smaller sections
  5. Use the print-to-PDF function in your browser as an alternative

Account and Access Issues

Login Problems

Issue: Unable to log in to your Carbon GPT account.

Solutions:

  1. Reset your password using the "Forgot Password" link
  2. Check if your account has been deactivated by an administrator
  3. Verify that you're using the correct email address
  4. Clear browser cookies and cache
  5. Check if your organization uses SSO and follow appropriate login procedures

Permission Denied Errors

Issue: Receiving "Permission Denied" when accessing certain features.

Solutions:

  1. Check your user role and permissions
  2. Request additional permissions from your account administrator
  3. Verify team membership if permissions are team-based
  4. Check if the feature is included in your subscription plan
  5. Ensure you're accessing the correct organization if you belong to multiple

Multi-Factor Authentication Issues

Issue: Problems with MFA during login.

Solutions:

  1. Ensure your authentication app is synchronized with the correct time
  2. Use backup codes if you've lost access to your authentication device
  3. Contact your administrator to reset MFA if necessary
  4. Check if your MFA app needs updating
  5. Verify that you're entering the code before it expires

Integration Issues

Data Connector Problems

Issue: Data connectors fail to sync or import data.

Solutions:

  1. Verify connection credentials
  2. Check that source systems are online and accessible
  3. Review connector configuration and mapping
  4. Check for changes in source data structure
  5. Verify that necessary permissions are granted in source systems

SSO Configuration Issues

Issue: Single Sign-On is not working correctly.

Solutions:

  1. Verify IdP configuration settings
  2. Check SAML certificate expiration
  3. Ensure attribute mapping is correct
  4. Test connection from IdP side
  5. Review network and firewall settings that might block authentication

Performance Issues

Slow Loading Times

Issue: Carbon GPT interface or calculations are running slowly.

Solutions:

  1. Check your internet connection speed
  2. Clear browser cache and cookies
  3. Close unnecessary browser tabs and applications
  4. Try a different browser
  5. For large datasets, consider using data aggregation or sampling

Browser Compatibility Issues

Issue: Features not working correctly in your browser.

Solutions:

  1. Update to the latest browser version
  2. Try a different supported browser (Chrome, Firefox, Safari, Edge)
  3. Disable browser extensions that might interfere
  4. Enable JavaScript and cookies
  5. Check if your organization has any browser security policies that might affect functionality

Mobile Access Problems

Issue: Difficulty accessing or using Carbon GPT on mobile devices.

Solutions:

  1. Use the mobile app instead of the browser version if available
  2. Switch to desktop view on your mobile browser
  3. Rotate your device to landscape orientation for complex screens
  4. Ensure your mobile OS and browser are up-to-date
  5. Use a tablet or larger screen for complex data entry or analysis

Getting Additional Help

If you've tried the relevant troubleshooting steps and still need assistance:

  1. In-App Support: Use the AI Assistant by clicking the help icon
  2. Knowledge Base: Search our comprehensive documentation
  3. Email Support: Contact support@carbongpt.ai
  4. Support Ticket: Submit a detailed support ticket through your account
  5. Live Chat: Available during business hours for immediate assistance
  6. Phone Support: Available for Enterprise customers

When contacting support, please include:

  • Detailed description of the issue
  • Steps to reproduce the problem
  • Screenshots or error messages
  • Your browser and operating system
  • Recent changes that might be related to the issue