> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atlios.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common setup and workflow issues.

Use these checks when Atlios does not behave as expected. For broader questions,
see the [FAQ](/reference/faq).

## Store does not appear after installation

<Note>
  Confirm that installation completed in Shopify and that you returned to the
  Atlios workspace after approving permissions. If the store still does not
  appear, reconnect the store.
</Note>

## Scan results look stale

<Tip>
  Atlios re-checks products automatically after they change in Shopify and
  rescans on a schedule. Atlios tracks scan history, so make sure you are
  reviewing the latest completed scan.
</Tip>

## A fix is not available

Not every issue type has an automated or guided fix. Some catalog problems
need manual review in Shopify before Atlios can verify the result.

Check [Supported checks](/reference/supported-checks) to see whether the issue
type has a direct fix, reviewable suggestion, manual input, image workflow, or
inspect-only path.

## A fix was skipped

Atlios skips a fix when it cannot make a safe change. The product may have
changed since the scan, the issue evidence may be stale, AI may be unavailable,
or the suggested change may be empty or unchanged.

After manual edits, Atlios re-checks the product automatically. If the issue
still appears, open the issue activity to read the skip reason.

## Bulk action skipped some selected issues

Bulk actions exclude issues that need individual decisions. Manual-input,
review-required, already verifying, resolved, suppressed, and inspect-only
issues may be skipped from a bulk fix.

Filter by one rule first when you want the most predictable bulk result.

## Image job is still processing

Image jobs can take time, especially for larger batches. You can leave the page
and return from **Products > Running jobs**. Finished items appear for review as
they complete.

## Image matched to the wrong product

Go back to the match step before processing, or use manual matching to assign
the image to the correct product. If the job already processed, reject the
wrong output and start a corrected job.

## Image output looks wrong

Reject outputs that should not be published. Use regenerate when the template
is right but the result needs another pass. If the template is wrong, choose a
different template and reprocess the image before approving it.

## Transparent image did not export as expected

Transparent background removal outputs must use PNG. If you need JPEG or WebP,
use a solid background color instead of transparency.

## Published image issue still appears

Run a new catalog scan after publishing images. Image issues, such as wrong
size or format, are verified by scan results after Shopify has the updated
media.

## Suppressed issue came back

Removing a suppression allows Atlios to detect the issue again. If the
underlying catalog state still matches the rule, the issue can return on the
next scan.

## Storefront checks fail

<Warning>
  Storefront verification depends on the rendered product page. Confirm that the
  product is published, accessible, and using the expected storefront template.
</Warning>

## Google Merchant Center will not connect

Connecting to Google Merchant Center needs an account admin. If you see an admin
or permission error, confirm you are an admin on the Merchant Center account, not
just a Shopify or Atlios admin.

Other common causes:

* The Merchant Center ID is wrong. Copy the digits from the account switcher at
  [merchants.google.com](https://merchants.google.com).
* The account is already connected to this store. Disconnect first, then
  reconnect.
* Only a workspace owner can connect a Merchant Center account.

## Google Merchant Center issues are not appearing

The first sync starts a few minutes after you connect, while Atlios finishes
setting up with Google. After that, Atlios syncs every 4 hours. Use **Sync now**
on the Google Merchant Center card to pull the latest status sooner.

If the card shows **Access expired**, Google revoked the connection. Choose
**Reconnect** and approve access again.

## A Google Merchant Center issue is stuck on Verifying

A fixed GMC issue stays in **Verifying** until the next sync confirms Google
cleared the disapproval. Google can take time to re-review a product. Use **Sync
now** to check sooner, or wait for the next scheduled sync.

## Google Merchant Center products show as unlinked

**Unlinked products** are GMC issues Atlios could not match to a Shopify product,
usually because the product ID in Google does not map to a current Shopify
product. Resolve these from **Open in GMC**.