Welcome to CarbonGuru! 🌍

Get started with CarbonGuru in just a few steps. This guide will walk you through everything you need to know to start tracking the carbon footprint of your online shopping.

Quick Navigation

• Step 1: Create Your CarbonGuru Account
• Step 2: Install Your Browser Extension
  • Firefox Developer Edition (Recommended)
  • Google Chrome (Beta)
  • Safari / macOS (Beta)
• Step 3: Install the CarbonGuru Browser Extension
• Alternative: Install as Temporary Add-on
• Step 4: Update Your Extension
• Step 5: Connect Your Gmail Account
• Step 6: Email Forwarding
• Troubleshooting

---

Step 1: Create Your CarbonGuru Account

Register for a Free Account

1. Visit the Registration Page
   • Go to: https://carbonguru.io/wp-login.php?action=register
2. Enter Your Information
   • Username: Choose a unique username
   • Email: Enter your email address (you’ll receive a confirmation)
3. Check Your Email
   • Look for an email from CarbonGuru with your temporary password
   • Check your spam folder if you don’t see it within a few minutes
4. Log In for the First Time
   • Visit: https://carbonguru.io/wp-login.php
   • Enter your username and temporary password
   • You’ll be prompted to change your password – choose a strong password

✅ Checkpoint: You should now be logged into your CarbonGuru account!

---

Step 2: Install Your Browser Extension

Choose the browser you want to use with CarbonGuru. Firefox Developer Edition is our most tested platform, but Chrome and Safari are now available in beta!

---

Step 2A: Install Firefox Developer Edition (Recommended)

Why Firefox Developer Edition? CarbonGuru’s browser extension is currently optimized for Firefox Developer Edition, which allows unsigned extensions for development and testing.

Download Firefox Developer Edition

1. Visit the Official Download Page
   • Go to: https://www.mozilla.org/en-US/firefox/developer/
2. Download for Your Operating System
   • Windows: Click “Download Firefox Developer Edition” – save the installer
   • macOS: Click “Download Firefox Developer Edition” – save the .dmg file
   • Linux: Choose your distribution (most common is .tar.bz2)
3. Install Firefox Developer Edition
   • Windows:
     1. Run the installer (.exe file)
     2. Follow the installation wizard
     3. Choose “Custom” installation if you want to specify location
     4. Click “Install” and wait for completion
   • macOS:
     1. Open the .dmg file
     2. Drag the Firefox Developer Edition icon to your Applications folder
     3. Open Applications and double-click Firefox Developer Edition
     4. If you see a security warning, go to System Preferences → Security & Privacy → click “Open Anyway”
   • Linux:
     1. Extract the downloaded .tar.bz2 file: tar -xjf firefox-*.tar.bz2
     2. Move to /opt: sudo mv firefox /opt/firefox-developer
     3. Create symlink: sudo ln -s /opt/firefox-developer/firefox /usr/local/bin/firefox-developer
     4. Launch: firefox-developer
4. Launch Firefox Developer Edition
   • Open the browser – you should see the Firefox Developer Edition welcome screen

Enable Unverified Extensions (CRITICAL STEP)

⚠️ Important: This step is required for the CarbonGuru extension to work in Firefox Developer Edition.

1. Open About:Config
   • Type about:config in the Firefox address bar and press Enter
   • Click “Accept the Risk and Continue” when warned
2. Enable Unsigned Extensions
   • In the search box at the top, type: xpinstall.signatures.required
   • You should see one result with a toggle button
   • Click the toggle button to change the value from true to false
   • The row should now show: xpinstall.signatures.required = false
3. Verify the Setting
   • The value should remain false (dark toggle on the left side)
   • You don’t need to restart Firefox for this to take effect

How to Disable Unverified Extensions (If Needed)

If you want to revert this setting later for security:

1. Go back to about:config
2. Search for xpinstall.signatures.required
3. Click the toggle to change it back to true
4. Note: The CarbonGuru extension will stop working if you do this

✅ Checkpoint: Firefox Developer Edition is installed and configured for unsigned extensions!

---

Step 2B: Install CarbonGuru for Google Chrome

🆕 Chrome Support (Beta): CarbonGuru now supports Google Chrome! The Chrome extension uses the latest Manifest V3 standard.

Installation Steps for Chrome

1. Download the Extension
   • Click the download link above to get carbonguru-chrome-prod.zip
   • Save it to a location you can easily find (like Downloads or Desktop)
2. Extract the ZIP File
   • Windows: Right-click the ZIP file → “Extract All” → Choose a folder
   • macOS: Double-click the ZIP file to extract
   • Linux: Right-click → “Extract Here” or use unzip carbonguru-chrome-prod.zip
3. Open Chrome Extensions Page
   • Open Google Chrome
   • Type chrome://extensions in the address bar and press Enter
   • Or go to Menu (⋮) → More Tools → Extensions
4. Enable Developer Mode
   • In the top-right corner of the Extensions page, toggle “Developer mode” ON
   • You should see additional buttons appear: “Load unpacked”, “Pack extension”, etc.
5. Load the Extension
   • Click the “Load unpacked” button
   • Navigate to the extracted folder (the one containing manifest.json)
   • Select the folder and click “Select Folder” (Windows) or “Open” (macOS)
6. Verify Installation
   • The CarbonGuru extension should appear in your extensions list
   • Click the puzzle piece icon (🧩) in Chrome’s toolbar to pin CarbonGuru for easy access

Chrome Extension Notes

• Developer Mode Required: Since this is a development version, Developer mode must stay enabled
• Updates: To update, download the new ZIP, extract it to the same folder, and click the refresh icon (🔄) on the extension card in chrome://extensions
• “Errors” Button: You may see an “Errors” button on the extension card – this is normal for unpacked extensions and doesn’t affect functionality

✅ Checkpoint: The CarbonGuru icon should appear in your Chrome toolbar!

---

---

Step 2C: Install CarbonGuru for Safari (macOS)

🆕 Safari Support (Beta): CarbonGuru now supports Safari on macOS! Installation is simple – no Xcode or developer tools required.

Prerequisites for Safari

• macOS only: Safari extensions only work on Mac computers
• Safari 14+: Requires Safari 14 or later (included in macOS Big Sur and later)

Installation Steps for Safari

1. Download and Extract
   • Download CarbonGuru.app.zip from the link above
   • Double-click the zip file to extract CarbonGuru.app
2. Move to Applications
   • Drag CarbonGuru.app to your Applications folder
3. Open the App (Bypass Gatekeeper)
   • macOS will block unsigned apps by default. Use one of these methods:

   Option 1: Right-click → Open (Recommended)

   • Right-click (or Control-click) on CarbonGuru.app in /Applications
   • Select “Open” from the context menu
   • Click “Open” in the security dialog that appears

   Option 2: System Settings

   • If you see a “cannot be opened” warning, go to System Settings → Privacy & Security
   • Scroll down to the Security section
   • You should see “CarbonGuru.app was blocked” with an “Open Anyway” button
   • Click “Open Anyway” and confirm

   Option 3: Terminal (Advanced)

   • Open Terminal and run: xattr -cr /Applications/CarbonGuru.app
   • Then double-click to open normally
4. Confirm Extension Registration
   • Once the app opens successfully, it will show a window confirming the extension is installed
   • This registers the extension with Safari
5. Enable in Safari
   • Open Safari → Settings (or Preferences) → Extensions
   • Check the box next to “CarbonGuru” to enable it
   • Grant necessary permissions when prompted
6. Sign In
   • Click the CarbonGuru icon in the Safari toolbar
   • Sign in with your CarbonGuru account

Troubleshooting

• Extension not showing in Safari: Make sure you’ve opened the app at least once after bypassing Gatekeeper. The app must run to register the extension.
• App keeps getting blocked: Use the Terminal method (xattr -cr /Applications/CarbonGuru.app) to remove the quarantine attribute.
• No Xcode Required: This pre-built app works without any developer tools.

✅ Checkpoint: The CarbonGuru icon should appear in Safari’s toolbar!

Step 3: Install the CarbonGuru Browser Extension

Method 1: Direct Installation (Recommended)

1. Make Sure You’re Logged In
   • Ensure you’re logged into your CarbonGuru account at dev.carbonguru.io
2. Visit the Extension Download Page
   • Click this link: Install CarbonGuru Extension
3. Approve the Installation
   • Firefox will show a popup asking “Add CarbonGuru?”
   • Click “Add”
   • You may see a warning about unverified add-ons – click “Continue to Installation”
4. Confirm Installation
   • You should see “CarbonGuru has been added to Firefox”
   • The CarbonGuru icon should appear in your browser toolbar (top-right)

Method 2: Manual Installation from About:Debugging

If direct installation doesn’t work, use this method:

1. Download the Extension File
   • Right-click this link and choose “Save Link As”: carbonguru.xpi
   • Save it to your Downloads folder or Desktop
2. Open Firefox Debugging Page
   • Type about:debugging#/runtime/this-firefox in the address bar and press Enter
3. Load the Extension
   • Click the “Load Temporary Add-on…” button
   • Navigate to where you saved carbonguru.xpi
   • Select the file and click “Open”
4. Verify Installation
   • The extension should appear in the “Temporary Extensions” section
   • The CarbonGuru icon should appear in your toolbar

⚠️ Note: Temporary extensions are removed when you close Firefox. For permanent installation, use Method 1 or see the update instructions below.

✅ Checkpoint: The CarbonGuru extension is installed and visible in your browser!

---

---

Alternative: Install as Temporary Add-on

Use this method if you cannot or do not want to permanently enable unverified extensions in Firefox.

When to Use This Method

• You’re using regular Firefox (not Developer Edition) and can’t change settings
• You don’t want to permanently disable signature verification for security reasons
• You’re testing the extension and don’t need it permanently installed
• You’re on a managed/corporate computer where you can’t change Firefox settings

Step-by-Step: Temporary Installation

Step 1: Download the Extension File

1. Right-click this link and choose “Save Link As…”:
   • carbonguru.xpi
2. Save to an easy-to-find location
   • Save to your Desktop or Downloads folder
   • Remember where you saved it – you’ll need to find it again later
   • Do NOT rename the file – keep it as carbonguru.xpi
3. Verify the download
   • The file should be around 1-2 MB in size
   • File name should end with .xpi

Step 2: Open Firefox Debugging Page

1. Open a new tab in Firefox
2. Type this exactly in the address bar:
   • about:debugging#/runtime/this-firefox
3. Press Enter
   • You should see the Firefox Debugging page
   • The page title should say “This Firefox”

Step 3: Load the Temporary Add-on

1. Find the “Temporary Extensions” section
   • Look for the heading “Temporary Extensions” on the page
   • Under it, you’ll see a button labeled “Load Temporary Add-on…”
2. Click “Load Temporary Add-on…”
   • A file browser window will open
3. Navigate to where you saved the extension
   • Go to your Desktop or Downloads folder (wherever you saved it)
   • Find the file named carbonguru.xpi
4. Select the file and click “Open”
   • Firefox will load the extension immediately
   • You should see “CarbonGuru” appear in the Temporary Extensions list

Step 4: Verify Installation

1. Check the extension appears on the debugging page
   • You should see “CarbonGuru” with extension details
   • Shows: Name, version number, internal UUID
   • Status indicator should show it’s active
2. Look for the CarbonGuru icon in your toolbar
   • The CarbonGuru icon should appear in the top-right toolbar
   • It may be in the extensions menu (puzzle piece icon)
3. Test the extension
   • Click the CarbonGuru icon
   • The extension popup should open
   • You should see the CarbonGuru interface

Step 5: Pin the Extension (Optional but Recommended)

Make the icon always visible in your toolbar:

1. Right-click the toolbar area (near other extension icons)
2. Select “Customize Toolbar…”
3. Find the CarbonGuru icon in the available items
4. Drag it to your preferred position in the toolbar
5. Click “Done”

✅ Success! The CarbonGuru extension is now installed and ready to use!

Important: What Happens When You Close Firefox

How to Reinstall After Closing Firefox

Every time you open Firefox and want to use CarbonGuru, follow these quick steps:

1. Open Firefox
2. Go to about:debugging#/runtime/this-firefox
   • You can bookmark this page for quick access
3. Click “Load Temporary Add-on…”
4. Select carbonguru.xpi from your Desktop/Downloads
5. Click “Open”

⏱️ This takes about 15 seconds once you’re familiar with the process.

Tips for Easier Reinstallation

Tip 1: Bookmark the Debugging Page

1. Visit about:debugging#/runtime/this-firefox
2. Press Ctrl+D (or Cmd+D on Mac) to bookmark
3. Name it: “Load CarbonGuru Extension”
4. Save to your Bookmarks Bar for one-click access

Tip 2: Keep the .xpi File Easily Accessible

• Keep carbonguru.xpi on your Desktop (not buried in folders)
• Or create a “CarbonGuru” folder on your Desktop and keep it there
• Don’t delete or move the file after first installation

Tip 3: Create a Firefox Profile Just for CarbonGuru

Advanced users can create a dedicated Firefox profile with permanent settings:

1. Type about:profiles in Firefox address bar
2. Click “Create a New Profile”
3. Name it “CarbonGuru” and create it
4. Launch Firefox with this profile
5. In this profile, enable unsigned extensions permanently (Step 2 from main guide)
6. Switch to this profile when using CarbonGuru

Checking Temporary Extension Status

To see if the extension is currently loaded:

1. Go to about:debugging#/runtime/this-firefox
2. Look under “Temporary Extensions”
3. If CarbonGuru is listed → Extension is active ✅
4. If section is empty → Extension not loaded, reinstall it ❌

Comparing Installation Methods

Feature	Permanent Installation (Firefox Developer Edition)	Temporary Add-on (Any Firefox)
Stays after closing Firefox	✅ Yes	❌ No
Automatic updates	✅ Yes	❌ No (manual download)
One-time setup	✅ Yes	❌ Reinstall each time
Works in regular Firefox	❌ No (needs Dev Edition)	✅ Yes
Security setting change required	⚠️ Yes (about:config)	✅ No
Setup time	~10 minutes (once)	~15 seconds (each time)
Best for	Regular CarbonGuru users	Testing, occasional use, or restricted computers

Troubleshooting Temporary Add-on Installation

Problem: Can’t find “Load Temporary Add-on…” button

Solution:

• Make sure you’re at about:debugging#/runtime/this-firefox (not just about:debugging)
• Look under the “Temporary Extensions” heading, not “Extensions”
• Scroll down if needed – the button might be below the fold

Problem: “This add-on could not be installed” error

Solution:

• Make sure the file is named carbonguru.xpi (with .xpi extension)
• Re-download the file – it may have been corrupted
• Check file size – should be 1-2 MB, not a few KB
• Try downloading with a different browser and then loading in Firefox

Problem: Extension works but icon doesn’t appear in toolbar

Solution:

1. Click the puzzle piece icon (Extensions menu) in the toolbar
2. You should see CarbonGuru listed there
3. Click the gear icon next to CarbonGuru
4. Select “Pin to Toolbar”

Problem: Extension disappeared but Firefox is still open

Solution:

• Go to about:debugging#/runtime/this-firefox
• Check if the extension is still listed under “Temporary Extensions”
• If not listed, Firefox may have restarted in the background
• Reload the extension using the steps above

Updating the Temporary Add-on

When a new version of CarbonGuru is released:

1. Download the new .xpi file
   • Visit: carbonguru.xpi
   • Save it (it will overwrite the old version or save as a new file)
2. Remove the old temporary extension (if loaded)
   • Go to about:debugging#/runtime/this-firefox
   • Find CarbonGuru under “Temporary Extensions”
   • Click “Remove”
3. Load the new version
   • Click “Load Temporary Add-on…”
   • Select the newly downloaded .xpi file
   • The new version will load immediately
4. Verify the new version
   • Click the CarbonGuru icon
   • Check the version number at the bottom of the popup
   • It should show the new version number

✅ Checkpoint: You now know how to install and manage CarbonGuru as a temporary add-on!

Step 4: Update Your Extension

CarbonGuru offers two ways to keep your extension up to date:

Option A: Manual Update (User-Triggered)

When to use: When you see a notification about a new version, or want to ensure you have the latest features.

1. Click the CarbonGuru Extension Icon
   • Find the CarbonGuru icon in your Firefox toolbar (usually top-right)
   • Click the icon to open the extension popup
2. Check for Updates
   • Look for an “Update Available” notification in the popup
   • Or click the “Check for Updates” button (if visible)
3. Install the Update
   • Click “Update Now” when prompted
   • The extension will download the latest version
   • Firefox will prompt you to approve the update
   • Click “Update” or “Allow”
4. Reload the Extension
   • The extension may automatically reload
   • If not, close and reopen Firefox
   • Verify the new version number in the extension popup

Option B: Automatic Updates (Scheduled)

When it happens: CarbonGuru automatically checks for updates every 24 hours.

1. How It Works
   • The extension checks updates.json daily
   • If a new version is available, Firefox downloads it automatically
   • You’ll see a notification: “CarbonGuru has been updated”
2. Enable Auto-Updates (if disabled)
   • Type about:addons in the Firefox address bar
   • Find CarbonGuru in the list of extensions
   • Click the three-dot menu (⋯) next to CarbonGuru
   • Ensure “Allow automatic updates” is checked
3. Check Your Version
   • Click the CarbonGuru icon in your toolbar
   • Look for the version number at the bottom of the popup
   • Example: “Version 1.7.8.1363”

Force an Update Check

If you want to check for updates immediately:

1. Visit: about:addons
2. Click the gear icon (⚙️) at the top
3. Select “Check for Updates”
4. Firefox will check all extensions including CarbonGuru

✅ Checkpoint: You know how to update your extension manually and automatically!

---

Step 5: Connect Your Gmail Account (Optional)

Why connect Gmail? CarbonGuru can analyze your email receipts to automatically track carbon footprints from online purchases, even without visiting the shopping cart page.

Gmail integration uses Google OAuth to securely scan your inbox for order confirmations and automatically calculate carbon footprints.

Quick Start

1. Visit the Gmail & Email Settings page
2. Click “Connect Gmail Account”
3. Authorize CarbonGuru in the Google popup
4. Your receipts will be automatically processed

📖 For detailed instructions: Gmail Integration Setup Guide

✅ Checkpoint: Your Gmail is connected to CarbonGuru!

---

Step 6: Email Forwarding (Optional)

Why use email forwarding? Email forwarding lets you send order receipts from any email account (Outlook, Yahoo, work email, etc.) to CarbonGuru for carbon footprint analysis.

This is useful if you don’t use Gmail or want to process receipts from multiple email accounts.

Quick Start

1. Visit the Gmail & Email Settings page
2. Generate your unique email token (format: CG-XXXXXXXX)
3. Forward order receipts to: email_processing@carbonguru.io
4. Include your token in the subject line

📖 For detailed instructions: Email Forwarding Setup Guide

✅ Checkpoint: You can now process receipts from any email account!

---

Troubleshooting Common Issues

Extension Installation Problems

Problem: “This add-on could not be installed because it has not been verified”

Solution:

1. Make sure you’re using Firefox Developer Edition (not regular Firefox)
2. Check that xpinstall.signatures.required is set to false in about:config
3. Restart Firefox and try again

Problem: Extension icon doesn’t appear in toolbar

Solution:

1. Go to about:addons
2. Verify CarbonGuru is in the list and enabled
3. Right-click the toolbar and select “Customize Toolbar”
4. Look for the CarbonGuru icon and drag it to your toolbar

Problem: Extension disappears after closing Firefox

Solution:

• You installed as a “temporary extension” from about:debugging
• Use Method 1 (Direct Installation) from Step 3 for permanent installation
• Or reinstall using the .xpi file link each time you open Firefox

Account and Login Issues

Problem: Forgot password

Solution:

1. Visit: https://carbonguru.io/wp-login.php?action=lostpassword
2. Enter your username or email
3. Check your email for a password reset link
4. Click the link and create a new password

Problem: Didn’t receive confirmation email

Solution:

1. Check your spam/junk folder
2. Wait 10-15 minutes (emails can be delayed)
3. Try registering again – you may have made a typo in your email address
4. Contact support if still not receiving emails

Gmail Connection Issues

Problem: “Authorization failed” when connecting Gmail

Solution:

1. Make sure you’re logged into CarbonGuru first
2. Check that pop-ups are not blocked in Firefox
3. Try using an incognito/private window
4. Clear your browser cache and cookies, then try again

Problem: Gmail shows as connected but not scanning emails

Solution:

1. Disconnect and reconnect your Gmail account
2. Verify permissions at Google Account Permissions
3. Ensure CarbonGuru has “Read” access to Gmail
4. Wait 24 hours – initial scanning can take time for large inboxes

Extension Update Issues

Problem: Updates not installing automatically

Solution:

1. Go to about:addons
2. Click the three-dot menu (⋯) next to CarbonGuru
3. Ensure “Allow automatic updates” is checked
4. Manually trigger an update check (gear icon → Check for Updates)

Problem: Update check says “no updates available” but I know there’s a new version

Solution:

1. Check the version number at updates.json
2. Clear Firefox cache: Settings → Privacy & Security → Clear Data
3. Restart Firefox and check for updates again
4. As a last resort, uninstall and reinstall the extension

Firefox Developer Edition Issues

Problem: Can’t find xpinstall.signatures.required in about:config

Solution:

1. Make sure you’re in Firefox Developer Edition, not regular Firefox
2. Type the preference name exactly: xpinstall.signatures.required
3. If it still doesn’t appear, it may have been removed in newer versions – check Firefox version

Problem: Firefox won’t let me install Developer Edition alongside regular Firefox

Solution:

• Windows/Linux: You can install both. Just choose different installation directories
• macOS: Rename one of them (e.g., “Firefox Developer Edition.app”) before installing the other
• Both versions can coexist and run simultaneously

---

Need More Help?

Resources

• User Dashboard: View your carbon footprint data
• Product Footprints: See detailed product analysis
• Extension Updates: Check current version

Contact Support

If you’re still having trouble after trying the troubleshooting steps:

• Email: support@carbonguru.io (include your username and a description of the issue)
• Include:
  • Your CarbonGuru username
  • Firefox version (Help → About Firefox)
  • Extension version (visible in extension popup)
  • Operating system and version
  • Description of the problem and what you’ve tried

---

You’re Ready to Go

You’ve successfully set up CarbonGuru. Here’s what you can do now:

Start Analyzing

• Use the browser extension to analyze products and shopping carts while you shop
• Forward order receipts from any email account to get carbon footprints
• Visit the How-To Guide for all the ways to submit products for analysis

Review Your Footprints

• Visit your Carbon Dashboard to see your analyzed products and carts
• View detailed carbon footprint breakdowns for each product

Offset Your Impact

• Add carbon offsets or removals to your cart directly from any product footprint
• Choose from verified carbon credit portfolios at checkout