Troubleshooting

Find the failing layer before retrying the action.

Most product problems belong to one of a few boundaries: Shopify authorization, storefront access, staging state, session lifecycle, QA, available capacity or deployment authority. Start with the visible evidence.

Direct answer

Troubleshoot the affected layer in order, connection, staging, session, QA, billing and deployment, without exposing credentials or bypassing controls.

Store connection

The store does not connect or the active theme is missing.

Confirm the canonical myshopify.com domain, Shopify app-install permission and that the installation was completed from the intended merchant account. Reconnect through OAuth rather than pasting credentials.

Preview

The staging preview is blank, protected or returns 404.

Confirm the storefront password, open the staging URL directly and use Repair staging when required theme assets are missing. A live storefront that works does not prove the staging copy is complete.

Session

A session looks active or no specific lifecycle state appears.

Open the session to inspect its latest conversation and changeset. Older sessions outside the recent actionable queue may display Active session rather than an inferred build or review state.

QA

The implementation failed QA or does not match the preview expectation.

Request correction and describe the observed behavior. Do not approve solely because some checks passed, and do not use force deployment as the normal path around failed QA.

Automations and capacity

A background run failed or new work cannot start.

Check the Automation status, store connection and Billing capacity. An insufficient balance prevents the product from reserving enough Engineering Runs to begin qualifying work safely.

Support request

Send evidence without sending secrets.

Include the shop domain, session or run reference, visible status, expected behavior, observed behavior, time and safe reproduction steps. Never send passwords, Shopify tokens, JWTs, API keys or customer data.

Next step

Connect the store. Start with evidence.

Connect your store, review the audit and choose the first change you want TaskerArmy to prepare in staging.