Documentation Troubleshooting

11 / Find a fix

Troubleshooting

Start with the symptom, check the relevant screen and change one thing at a time.

For Purlia 1.0.14 min readUpdated 4 Nov 2026

A useful first check

Reproduce the issue on staging, note the affected URL and compare the setting against the relevant guide. Check browser errors and WooCommerce status where applicable. If a recent optimization/plugin change triggered it, test that change in isolation before making broad edits to the theme.

Common questions

WordPress says the theme stylesheet is missing

Upload the inner installable purlia-1.0.1.zip. A full submission/documentation bundle has another folder level and is not the theme installation file.

The homepage has empty image slots

Choose your own images in the native Image blocks or import the optional demo Media. Purlia 1.0.1 does not load its content photos from the theme folder or import them on activation.

Editing the Home page does not change Home 1

Home 1 uses the Front Page template’s content. Edit it through Appearance → Editor → Templates → Front Page. Home 2–4 use page content with their matching templates.

An updated template still looks like the old version

Check whether the Site Editor has a saved customized template/part. That override can take precedence over the theme file. Back it up before selectively resetting it; avoid resetting every customization just to diagnose one screen.

The wrong image appears after import

Finish the provided demo finalizer so attachment IDs match the target site. If working manually, select the correct Media item again in the Image block. Inspect the actual page after clearing relevant caches.

Color circles do not appear

Check that Color is a global attribute with slug color, that terms have swatch colors and that the product uses those values. Other attribute selectors remain native. Do not create a second local text attribute as a substitute.

A variation cannot be added to the basket

Check its selected attributes, enabled status, price and stock. Each sellable variation needs valid data. If a third-party extension adds fields, test its native submission path and verify its own configuration.

Add to cart reloads the page or the drawer does not open

Confirm that JavaScript and the WooCommerce cart API can load. Some product types/extension forms use native submission intentionally. On staging, inspect optimization conflicts, cached security tokens and API restrictions; exclude personalized cart responses from caching.

A shop filter is empty or returns no items

Confirm published products have values in the matching global attribute. Reset other filters and check catalog visibility/stock. Edit the catalog template’s native filter blocks, not a classic Widgets sidebar.

The Patterns page is empty

Use the patterns page slug and library pattern. Assign products to the patterns product-category slug. Use knitting/crochet product tags for the craft filters. Restore the supplied library query block if its structure was rebuilt incorrectly.

The Register form is missing

Enable registration on My Account in WooCommerce → Settings → Accounts & Privacy. The theme styles the form when WooCommerce makes it available.

The newsletter says it will be available soon

Connect MC4WP, choose the correct Audience and select a published form in the Footer. Verify the form belongs to this site; an imported ID does not create a connected Mailchimp account.

The contact form or recovery email does not arrive

Check the form notification or WordPress/WooCommerce email configuration and the recipient’s spam folder. Test delivery separately from page styling; a visible success message alone is not proof of inbox delivery.

Shipping options do not appear

Review the customer address, shipping zones/methods and whether the product is physical or Virtual. A free-shipping announcement does not create a method. Test a known address against the intended zone.

Pages or products return 404 after migration

Confirm their published slugs and update internal links. Re-save Settings → Permalinks. If the issue continues, ask the host to inspect rewrite configuration.

Order tracking does not find an order

Use the actual WooCommerce order ID and the matching billing email. Verify those values on a synthetic/test order. Do not weaken WooCommerce’s order access checks to make incorrect details work.

If the issue remains

Send the steps to reproduce it and the affected screen to the support channel shown with your purchase. Include version details and a screenshot that does not reveal customer information or service credentials. See Launch and support for a useful support-request template.

Your store guide