Troubleshooting SEO Grid — session, saves & billing
Common issues when using SEO Grid.
Save failed or row shows an error
Section titled “Save failed or row shows an error”| Check | Action |
|---|---|
| Session expired | Go to Shopify Admin → Apps → SEO Grid to refresh OAuth |
| Validation error | Shorten meta title/description or fix handle format per Shopify rules |
| Network blip | Retry Save on the same row |
| Wrong shop | Confirm header shows your .myshopify.com domain |
Changes not visible in Shopify Admin
Section titled “Changes not visible in Shopify Admin”- Confirm the row showed success after Save.
- Hard-refresh the Admin resource page — Shopify Admin may need a few refreshes before changes appear (normal Shopify backend caching).
- Check you edited the correct locale column if using translations.
Redirected to plan selection {#redirected-to-plan-selection}
Section titled “Redirected to plan selection {#redirected-to-plan-selection}”- Expected when no active App Pricing subscription is on file.
- Select Basic (3-day free trial, then USD $6/month) in Shopify Admin, then open Apps → SEO Grid again.
- See Billing & plans.
Asked to sign in again
Section titled “Asked to sign in again”Go to Shopify Admin → Apps → SEO Grid to refresh your session. SEO data in Shopify is unchanged — signing in again does not revert saved SEO.
App opens wrong store
Section titled “App opens wrong store”SEO Grid sessions are per shop. Always launch from Apps → SEO Grid in the Admin of the store you intend to edit.
Browser agent cannot find Save
Section titled “Browser agent cannot find Save”- Ensure the page loaded the full grid (not an OAuth redirect).
- Use semantic selectors documented in AI agents.
- Save one row at a time.
URL handle change — old link still works
Section titled “URL handle change — old link still works”That is expected. When you change a URL handle and Save succeeds, old storefront URLs should still reach the resource.
| What changed | Where to manage redirects |
|---|---|
| Primary locale handle (products, pages, or blog posts) | Shopify Admin → Content → Menu → URL redirects — review, edit, or remove the new row |
| Translated locale handle only | Redirect list usually unchanged; old locale-prefixed URLs still redirect on the storefront |
See URL handle changes and redirects and Multi-locale columns.
Save All — some rows failed
Section titled “Save All — some rows failed”Save All continues through the batch even when individual rows fail.
| Check | Action |
|---|---|
| Invalid handle or validation | Read the error under Save on the failed row; fix the value |
| Partial batch | Succeeded rows clear their highlight; failed rows stay highlighted |
| Summary banner | Dismiss with × — dirty rows remain; fix and click Save All (M) again |
| Retry one row | Fix the row and click Save on that row only |
Highlights look wrong after Admin edit
Section titled “Highlights look wrong after Admin edit”If you edited the same product, page, or article in Shopify Admin while the grid tab stayed open, amber highlights may not match reality. Refresh the grid page to reload saved baselines.
Import validation failed
Section titled “Import validation failed”Import never changes the grid until Validate passes.
| Check | Action |
|---|---|
| Wrong shop or content type | Open the grid for the same store and type as the export |
| Locale mismatch | Match locale columns to the export (same codes and order) |
| Row info mismatch | Enable the same Row info fields as when you exported |
| Row not on page | Import only rows visible on the current page (≤25); paginate or filter to include them |
| Invalid handle | Fix handle format in the file, then Validate again |
| Edited textarea | After any paste or edit, click Validate again before Apply |
See Grid transfer for the full workflow.
Contact support
Section titled “Contact support”Email tech@k2.digital with:
- Your
.myshopify.comdomain - Content type (products / pages / articles / metaobjects)
- What you expected vs what happened
- Screenshots if possible
See Support.