Skip to main content

Troubleshooting

Need to unblock something fast? This page consolidates the most common issues and fixes from across the docs. Jump to the section that matches your problem:

API Keys & Authentication​

Invalid or revoked key​

  • Verify the key exists and is active in Settings → API Keys.
  • Copy the key again and ensure there are no extra spaces or line breaks.
  • Rotate the key if you suspect it has been exposed, then update every integration.

Insufficient permissions​

  • Confirm you're using an account with access to the target site.
  • Check that the feature is included in your current plan (see Pricing & Billing).

Rate limit exceeded​

  • Implement exponential backoff when you receive HTTP 429 responses.
  • Batch non-urgent operations and spread them across the day.
  • Upgrade your plan or contact support if you need a higher quota.

Site Uploads & Organization​

"Site not found" errors​

  • Double-check the site ID in your request or configuration.
  • Ensure the API key you’re using belongs to the same organization as the site.
  • Confirm the site hasn’t been deleted or archived.

Images not appearing after upload​

  • Verify the folder structure: /{site-name}/{branch}/{commit}/filename.png.
  • If you rely on GitHub Actions, wait for the workflow to finish—uploads happen automatically at the end of the job.
  • Make sure file formats are supported (PNG, JPEG, WebP).

Storage limits reached​

  • Review usage in the dashboard or the site details panel.
  • Delete obsolete branches, commits, or images to reclaim space.
  • Check plan limits and upgrade if the project has outgrown the current tier.

Reports & Comparisons​

Unexpected failures below the threshold​

  • Inspect the diff images to confirm whether changes are intentional.
  • Consider raising or lowering the threshold for pages with dynamic content.
  • Make sure fonts and assets finish loading before screenshots run (add waits or disable animations when possible).

No diff images generated​

  • Allow a few more seconds—comparisons can take time after upload.
  • Verify that both base and compare folders contain matching image names.
  • Ensure your plan has sufficient storage and report retention.

PR comments or checks missing​

  • Grant pull-requests: write permission to the job in GitHub Actions.
  • Confirm post-pr-comment (and github-token) are set when using the official action.
  • Check workflow logs for API errors or authentication failures.

Still stuck? Reach out at support@godiffy.app and include relevant comparison IDs, site IDs, or workflow logs so we can help quickly.