Skip to main content

Common Errors

When a deployment fails, open its log from the dashboard — it contains the full output of the deploy. Below are the most common errors and their fixes.

GitHub connection errors​

"Github installation not available"​

The Theme Deploy GitHub App is no longer installed (or lost access to your repository). This also deactivates your deployment configuration.

Fix: Reinstall the GitHub App from the repository picker and re-select your repository.

"No access to the repository"​

The GitHub App installation exists but can't see the selected repository — usually because the installation was limited to specific repos and this one wasn't included.

Fix: On GitHub, go to Settings → Applications → Theme Deploy and grant access to the repository.

"Not authenticated with Github!"​

Your GitHub session in Theme Deploy has expired.

Fix: Click Login with GitHub again from the dashboard.

Deployment errors​

"Deployment failed!"​

A generic failure during clone or upload. Common causes:

  • Invalid Liquid or JSON in the theme (Shopify rejects the upload) — check the log for the specific file.
  • The repository doesn't contain a valid theme structure at its root.
  • A transient network or Shopify API issue — retry with the sync button.

"Live theme not found"​

Theme Deploy couldn't find a published (live) theme on your store to deploy to or read settings from.

Fix: Make sure your store has a published theme under Online Store → Themes.

"Can't upload Shopify theme"​

Creating a new preview theme failed. The most frequent cause is hitting Shopify's theme limit (20 themes on most plans).

Fix: Delete unused themes (including stale [TD] previews) from your Shopify admin and redeploy.

Status: plan_limit_exceeded​

Your subscription's monthly usage allowance ran out, so the deployment was not run.

Fix: Upgrade your plan from the Account page, or wait for your usage to reset at the next billing cycle.

Access errors​

"Unauthorized!" / logged out unexpectedly​

Sessions last one hour.

Fix: Reopen the app from your Shopify admin to start a fresh session.

"Request not valid!"​

The request's signature check failed — typically from an expired or malformed install/callback URL.

Fix: Start the flow again from your Shopify admin rather than a bookmarked URL.

Still stuck?​

Check the FAQ, or contact support from themedeploy.io with your store domain and the deployment log.