Troubleshooting Guides

If you encounter issues, this guide will help you resolve the most common problems.

I can’t find my project in the Dashboard#

  • Project folders must be named with the doc2 prefix (e.g. doc2-blog).
  • Ensure the folder is shared with bot@doc2.site and that the bot has Editor access. Without these permissions, doc2.site cannot access or publish your content.
  • After sharing, it may take a few moments for the project to appear in the dashboard. Refresh the page to trigger a rescan.

Subdomain already taken or not working#

  • Subdomains must be unique. If your chosen subdomain is already in use, you’ll need to select a different one.
  • Ensure you’ve set both the Preview and Live URLs correctly in the browser extension’s configuration.

The Browser Extension actions are not visible in Google Docs or Sheets#

  • Confirm that you have installed the Browser Extension for Chrome or Edge.
  • Make sure you’ve configured your credentials (email and secret) and added your project configuration inside the extension options.

I get an error when publishing a document or sheet#

  • Ensure that the document is fully saved and accessible before attempting to publish.
  • Ensure the document is properly formatted. For example, you should avoid inserting unsupported characters.
  • You may have hit a limitation: check that your project hasn’t exceeded the document or size limits based on your Plan (e.g., 25 MB max for content, 5 MB per upload, etc.).

My content isn’t showing up after publishing#

  • Make sure the document or spreadsheet is saved in Google Drive. Unsaved or newly created content might not be picked up immediately by the system.
  • It may take up to 2 minutes for content changes to propagate through the edge network globally.
  • Clear your browser cache or force a reload using Ctrl + F5 (Windows) or Cmd + Shift + R (macOS) to bypass cached versions.
  • Check that you selected the correct publishing target (Private, Preview, or Live). Only content published to the Live workspace will show up on production URLs.
  • If using a custom domain, verify that the domain is properly linked to your project.

My page is showing unstyled content#

  • If you are using a custom theme from a CDN (like GitHub or Cloudflare Pages), ensure the theme URLs are correctly entered in the doc2.live.config sheet.
  • The published content must be linked to the correct theme. Without, scripts and styles won’t load properly.

I can’t publish to the Live workspace#

  • Check that your account has access to the Business or Enterprise plan. The Live workspace is not available on the free Developer Plan.
  • You must publish your content to the Preview workspace before promoting it to Live. This is a safety measure to prevent accidental live publishing without a preview check.