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

# FAQ & troubleshooting

> Get quick answers for AddressPill setup, checkout activation, post-checkout blocks, order tags, holds, automations, and common troubleshooting steps.

## Frequently asked questions

### I turned on in-checkout validation, but I do not see it in checkout. Why?

Check Shopify **Settings > Checkout > Checkout rules** and confirm **AddressPill Checkout Validation** is turned on.

### Post-checkout is enabled, but nothing appears on Thank You page.

Open Shopify theme editor and make sure the AddressPill app block is added to both:

* **Thank you**
* **Order status**

Then save theme changes.

### Should I start with warning mode or block mode?

Start with warning mode first. After you verify behavior in your store, move important rules to block mode.

### Which settings matter most for new stores?

Start with:

1. Require house number
2. Duplicate name check
3. Post-checkout correction window
4. Basic order tagging

Then add holds and advanced automations.

### Why was an order tagged or put on hold?

This comes from your configured **Tag orders** and **Orders on hold** settings.

### Where can I get support?

* In-app chat from **Support & Billing** in AddressPill
* Public FAQ: [AddressPill FAQs](https://www.pillsoftware.com/apps/addresspill/faqs)

## Troubleshooting checklist

1. Confirm your plan is active.
2. Confirm you clicked **Save settings** after changes.
3. Confirm Shopify checkout/app-block activation steps were completed.
4. Re-test with a new checkout.
5. If still unresolved, contact support with your shop domain and test timestamp.

## FAQ

### What is the fastest way to verify setup is correct?

Run one test checkout for in-checkout and one post-checkout test with Thank You and Order Status blocks enabled.

### Which pages in this documentation are most important?

General walkthrough, in-checkout setup, post-checkout setup, and the six Settings pages.

### What should I send to support if something is wrong?

Your shop domain, test order time, and which step failed (checkout rules, app block, tags, holds, or automations).