# FAQ & troubleshooting
Source: https://docs.pillsoftware.com/faq/shopify-address-validation-faq
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).
# Automations
Source: https://docs.pillsoftware.com/features/automations
Trigger immediate and follow-up Shopify Flow automations from AddressPill address issue events.
## Automations
### What this does
AddressPill sends events to Shopify Flow so you can trigger automated actions.
### Why this matters
Your store can react faster to address issues with less manual work.
### What you can control
* Immediate Flow event when an issue is found
* Follow-up Flow event if the issue stays unresolved
* Flow-based customer communication workflows
### Where to configure
Open [Automation settings](/settings/shopify-flow-automations).
## FAQ
### Which automation system does AddressPill support?
AddressPill uses Shopify Flow events for automation workflows.
### What is the difference between immediate and follow-up events?
Immediate runs when the issue is detected. Follow-up runs later only if the issue is still unresolved.
### What can I automate with these events?
Team notifications, triage workflows, and customer communication sequences.
# In-checkout validation
Source: https://docs.pillsoftware.com/features/in-checkout-validation
Prevent invalid shipping addresses before checkout completion with house number checks, name checks, email typo checks, regex rules, and field limits.
## In-checkout validation
![In-checkout validation tutorial thumbnail]()
Open the in-checkout setup video on YouTube.
### What this does
AddressPill validates the shipping address while the customer is still in checkout.
### Why this matters
You catch issues before payment. This reduces bad addresses entering your fulfillment pipeline.
### What you can control
* Require house number
* Check duplicate first/last name
* Detect special characters in address fields
* Detect common email typos
* Block with custom regex pattern
* Set field length limits for address, name, and company
* Choose rule behavior: **warning** or **block checkout**
### Where to configure
Open [In-checkout settings](/settings/in-checkout-validation-rules).
## FAQ
### Which issues can in-checkout validation catch?
It can catch missing house numbers, duplicate names, special characters, email typos, regex matches, and field length violations.
### Should I use warning or block mode?
Use warning mode first for safe rollout, then enable block mode for critical rules.
### Where do I configure in-checkout rules?
In **Settings > In-checkout validation**.
# Orders on hold
Source: https://docs.pillsoftware.com/features/orders-on-hold
Pause fulfillment for unresolved address problems and optionally auto-release order holds after customer correction.
## Orders on hold
### What this does
AddressPill can put orders on hold when unresolved post-checkout issues are detected.
### Why this matters
It prevents shipping before critical address issues are resolved.
### What you can control
* Enable hold behavior
* Set hold when unresolved issue is detected
* Auto-release hold after correction
* Define hold reasons used by your team/automations
### Where to configure
Open [Orders on hold settings](/settings/orders-on-hold-for-address-issues).
## FAQ
### What does Orders on hold do in AddressPill?
It pauses fulfillment for unresolved address issues.
### Can holds be released automatically?
Yes, you can enable auto-release after correction.
### What are hold reasons?
Hold reasons are labels your team or automations can use to track why an order was paused.
# Packing stations / PO boxes
Source: https://docs.pillsoftware.com/features/packing-stations-po-boxes
Detect and block PO boxes and packstations in checkout and post-checkout using custom keywords and field scanning.
## Packing stations / PO boxes
### What this does
AddressPill detects packing station and PO box patterns from your keyword list.
### Why this matters
Many merchants cannot ship to these destinations for certain carriers or workflows.
### What you can control
* Enable packing station detection
* Block in **in-checkout validation**
* Block in **post-checkout validation**
* Choose checkout action: warning or block
* Add custom keywords
* Choose extra fields to scan (Address line 2, Company)
### Where to configure
Open [Packing station settings](/settings/packing-stations-po-boxes).
## FAQ
### Can AddressPill block PO boxes in Shopify checkout?
Yes, you can block or warn in in-checkout validation and also enforce rules in post-checkout validation.
### How does packstation detection work?
AddressPill scans address text against your keyword list and selected fields.
### Which extra fields can be scanned?
Address line 2 and Company, in addition to address line 1 and city.
# Post-checkout validation
Source: https://docs.pillsoftware.com/features/post-checkout-validation
Validate addresses after purchase on Thank You and Order Status pages with correction windows, normalization, and low-risk auto-fixes.
## Post-checkout validation
![Post-checkout validation tutorial thumbnail]()
Open the post-checkout setup video on YouTube.
### What this does
AddressPill validates addresses after purchase on the Thank You and Order Status pages.
### Why this matters
You can keep checkout smooth while still catching and fixing risky addresses.
### What you can control
* Allow house number in address line 2
* Validate duplicate names after checkout
* Automatic normalization:
* ZIP formatting
* spacing fixes
* move house number to address line 1
* remove stray leading zero in house number
* Auto-apply small low-risk corrections (city/ZIP/region)
* Set customer correction window (minutes)
### Where to configure
Open [Post-checkout settings](/settings/post-checkout-validation-rules).
## FAQ
### What is post-checkout validation in AddressPill?
It is address validation that runs after order placement, not during checkout.
### Can AddressPill auto-fix small address issues?
Yes, you can enable low-risk auto-corrections for city, ZIP, and region typos.
### Can customers still correct their address after checkout?
Yes, based on the correction window you set in post-checkout settings.
# Tag orders
Source: https://docs.pillsoftware.com/features/tag-orders
Apply Shopify order tags automatically for missing house numbers, unconfirmed addresses, spelling issues, and address format issues.
## Tag orders
### What this does
AddressPill can add Shopify tags when post-checkout validation finds address issues.
### Why this matters
Your team can filter and prioritize risky orders quickly.
### What you can control
* Tag for missing house number
* Tag for unconfirmed address
* Tag for spelling issue
* Tag for format issue
* Generic fallback issue tag
### Where to configure
Open [Tag order settings](/settings/tag-orders-by-address-issue).
## FAQ
### What are AddressPill order tags used for?
They help your team filter and prioritize risky orders in Shopify.
### Can I set different tags for different issue types?
Yes, you can set specific tags per issue type and one generic fallback tag.
### Do tags depend on post-checkout validation?
Yes, tags are applied when post-checkout validation runs and finds issues.
# General walkthrough
Source: https://docs.pillsoftware.com/get-started/addresspill-shopify-walkthrough
Learn the AddressPill dashboard, key metrics, quick actions, and settings so you can launch Shopify address validation with confidence.
## General walkthrough
This page gives you a quick tour of AddressPill.
![AddressPill general walkthrough thumbnail]()
Open the full walkthrough video on YouTube.
## Dashboard metrics
When you open AddressPill, you see 4 main numbers:
* **Protected checkouts**: how many checkouts were validated
* **Address issues**: how many address problems were detected
* **Delivery value saved**: estimated value saved by avoiding failed deliveries
* **Validation cost**: your validation-related spend
These numbers help you understand impact at a glance.
## Quick actions
Under the metrics, you see **Quick Actions**:
* **In-checkout validation**
* **Post-checkout validation**
Use these shortcuts to open the most important setup areas quickly.
## Sidebar areas (simple explanation)
* **Settings**: where you configure all validation behavior
* **Support & Billing**: support and plan management
## Settings tabs you should know
Inside **Settings**, you can configure:
1. **In-checkout validation**
2. **Post-checkout validation**
3. **Packing stations / PO Boxes**
4. **Tag orders**
5. **Orders on hold**
6. **Automations**
Each of these is explained in the **Features** and **Settings** sections of this documentation.
## FAQ
### What are the four dashboard metrics in AddressPill?
Protected checkouts, Address issues, Delivery value saved, and Validation cost.
### Where can I configure all validation behavior?
In the **Settings** area of AddressPill.
### Which settings tabs are most important for beginners?
Start with In-checkout validation, Post-checkout validation, Tag orders, and Orders on hold.
# In-checkout setup
Source: https://docs.pillsoftware.com/get-started/in-checkout-address-validation-setup
Enable AddressPill in-checkout validation in app settings and Shopify Checkout rules to stop invalid shipping addresses before order placement.
## In-checkout validation setup
In-checkout validation checks the shipping address **inside Shopify checkout**, before the customer places the order.
It helps you stop invalid addresses early.
![In-checkout validation tutorial thumbnail]()
Open the in-checkout setup video on YouTube.
## Step-by-step
1. In AddressPill, open **Settings**.
2. If you do not have a plan yet, choose a plan first.
3. Turn on **In-checkout validation**.
4. Enable the checkout rules you want.
5. Click **Save settings**.
6. In Shopify admin, open **Settings** (bottom-left).
7. Open **Checkout**.
8. Scroll down to **Checkout rules**.
9. Open **AddressPill Checkout Validation**.
10. Click **Turn on**.
11. Select **Allow all customers to complete checkout**.
12. Click **Save**.
## Result
In-checkout validation is now active for your store.
Customers get address feedback during checkout based on your selected rules.
## FAQ
### What does in-checkout validation do in Shopify?
It validates the shipping address during checkout before the customer places the order.
### Why do I need both AddressPill settings and Shopify Checkout rules?
AddressPill defines the rules, and Shopify Checkout rules activates the checkout validation extension.
### Which Shopify option should I select when turning it on?
Select **Allow all customers to complete checkout**, then save.
# Post-checkout setup
Source: https://docs.pillsoftware.com/get-started/post-checkout-address-validation-setup
Set up post-checkout validation on Thank You and Order Status pages to detect and resolve shipping address issues after purchase.
## Post-checkout validation setup
Post-checkout validation runs **after checkout**.
It checks addresses on the **Thank You** and **Order Status** pages.
This is useful if you want lower checkout friction while still catching issues.
![Post-checkout validation tutorial thumbnail]()
Open the post-checkout setup video on YouTube.
## Step-by-step
1. In AddressPill, open **Settings**.
2. Open the **Post-checkout validation** tab.
3. If you do not have an active subscription, choose a plan.
4. Turn on **Post-checkout validation**.
5. Enable the post-checkout features you want.
6. Click **Save settings**.
7. In Shopify admin, open **Online Store**.
8. Open **Themes** and click **Edit theme**.
9. In the top bar, switch page selector to **Checkout and customer accounts**.
10. Click **Apps** (top-left).
11. Add **AddressPill thank-you-validation** with the plus button.
12. Select **Thank you**.
13. Switch to **All**, click plus again, and select **Order status**.
14. Save theme changes.
## Result
Post-checkout validation is now active for this shop.
## FAQ
### What does post-checkout validation do in Shopify?
It validates addresses after purchase on Thank You and Order Status pages.
### Why is the app block required in the theme editor?
The app block is what displays and runs the post-checkout validation experience for customers.
### Which pages must include the AddressPill app block?
Both **Thank you** and **Order status**.
# Overview
Source: https://docs.pillsoftware.com/index
Reduce failed deliveries with in-checkout and post-checkout address validation for Shopify. Set rules, block risky addresses, tag orders, and automate follow-up flows.
## What AddressPill does
AddressPill helps you avoid shipping errors in Shopify.
It checks customer addresses at two moments:
* **In-checkout validation**: before the order is placed
* **Post-checkout validation**: after the order is placed
This means you can catch problems early, reduce manual work, and protect fulfillment quality.
## Start here
See the full app flow and understand every area in the sidebar.
Enable checkout validation and stop invalid addresses before payment.
Enable Thank You and Order Status validation after purchase.
Understand what each feature does in plain language.
## How to use this documentation
1. Start with **Get Started**.
2. Read **Features** to understand what each module does.
3. Use **Settings** pages when you configure your store.
4. Open **FAQ & Troubleshooting** if something does not work.
AddressPill is designed to be simple. If you are not technical, follow the setup steps exactly in order.
## FAQ
### What is AddressPill for Shopify?
AddressPill is a Shopify app that validates shipping addresses before and after checkout to reduce delivery errors.
### What is the difference between in-checkout and post-checkout validation?
In-checkout runs before payment. Post-checkout runs after payment on Thank You and Order Status pages.
### Which page should I read first?
Start with the Get Started walkthrough, then follow the two setup pages for in-checkout and post-checkout.
# In-checkout settings
Source: https://docs.pillsoftware.com/settings/in-checkout-validation-rules
Configure checkout rules for house numbers, duplicate names, special characters, email typos, regex patterns, and field limits in AddressPill.
## In-checkout validation settings
Use this tab to define what AddressPill checks in checkout.
## How to enable
1. Open **Settings** in AddressPill.
2. Open **In-checkout validation**.
3. Turn the top toggle on.
4. Select your rules.
5. Click **Save settings**.
6. Confirm Shopify **Checkout rules** are enabled for AddressPill.
## Rules explained
* **Address validation (require house number)**: checks if a street number exists.
* **Check names (first and last name must differ)**: catches duplicate names.
* **Block special characters in address**: flags unusual symbols.
* **Check email typos**: catches common domain typos.
* **Block address with custom regex**: blocks patterns you define.
* **Length limits**: restricts max characters for address fields, names, and company.
For many rules, you can choose:
* **Show warning only**
* **Block checkout**
If you are new, start with warnings first, then move to blocking rules after testing.
## FAQ
### What is the most important in-checkout rule?
Most merchants start with **require house number** because it prevents common delivery failures.
### Can I activate only some in-checkout rules?
Yes, you can enable only the rules you need and leave others off.
### Is it safe to block checkout immediately?
It is safer to start with warnings, validate behavior, and then block critical rules.
# Orders on hold
Source: https://docs.pillsoftware.com/settings/orders-on-hold-for-address-issues
Control hold behavior for unresolved address issues, including hold triggers, auto-release, and hold reason values.
## Orders on hold settings
Use this tab to pause fulfillment while address issues are unresolved.
## How to configure
1. Open **Settings**.
2. Open **Orders on hold**.
3. Turn hold behavior on.
4. Choose whether to set hold on unresolved issues.
5. Choose whether to auto-release after correction.
6. Define your hold reasons.
7. Click **Save settings**.
## Controls explained
* **Set hold when unresolved issue is detected**
* **Auto-release hold after correction**
* **Hold reasons**: custom values your team can track
This works best together with post-checkout validation, because post-checkout determines unresolved issue state.
## FAQ
### When should I enable order holds?
Enable holds when unresolved address issues must be reviewed before fulfillment.
### What does auto-release hold do?
It removes the hold automatically after a successful correction flow.
### Are hold reasons mandatory?
They are strongly recommended so teams and automations understand why an order is paused.
# Packing stations / PO boxes
Source: https://docs.pillsoftware.com/settings/packing-stations-po-boxes
Configure keyword detection and blocking behavior for packstations and PO boxes in checkout and post-checkout flows.
## Packing stations / PO boxes settings
Use this tab when you need to detect or block PO box style destinations.
## How to enable
1. Open **Settings**.
2. Open **Packing stations / PO Boxes**.
3. Turn on detection.
4. Configure where to block:
* in-checkout
* post-checkout
5. Add your custom keyword names.
6. Click **Save settings**.
## Main controls
* **Block packing stations in in-checkout validation**
* **If detected in checkout**: warning or block
* **Block packing stations in post-checkout validation**
* **Packing station / PO Box names**: your keyword list
* **Extra lines to scan**:
* Address line 2
* Company
Address line 1 and city are always scanned.
## FAQ
### How do I block packstations in checkout?
Enable packstation detection, then turn on in-checkout blocking and choose block mode.
### Can I use custom packstation keywords?
Yes, add your own keywords in the name list.
### Why would I scan Address line 2 and Company?
Customers often place PO box or post number details in those fields.
# Post-checkout settings
Source: https://docs.pillsoftware.com/settings/post-checkout-validation-rules
Set post-checkout normalization, correction windows, and low-risk auto-corrections for Shopify shipping addresses.
## Post-checkout validation settings
Use this tab to control how AddressPill works after checkout.
## How to enable
1. Open **Settings**.
2. Open **Post-checkout validation**.
3. Turn the top toggle on.
4. Enable the options you need.
5. Click **Save settings**.
6. Ensure app blocks are added to **Thank You** and **Order Status** pages.
## Options explained
* **Allow house number in address line 2**: accepts house number from line 2.
* **Validate customer name rules**: checks duplicate names after purchase.
* **Automatically update postal code formatting**: cleans ZIP formatting.
* **Automatically assign house number to address line 1**: moves number from line 2 when needed.
* **Automatically correct spacing**: fixes spacing between street and number.
* **Remove stray "0" house numbers**: removes leading zero mistakes.
* **Auto-apply small corrections**: applies low-risk city/ZIP/region typo fixes.
* **Customer correction window (minutes)**: defines how long customers can still update address.
## FAQ
### What is the correction window in post-checkout settings?
It is the time (in minutes) during which customers can still fix their address after checkout.
### What does auto-apply small corrections change?
It applies low-risk fixes like city, ZIP, or region typos.
### Does post-checkout replace in-checkout validation?
No, they solve different moments. Many stores use both together.
# Automations
Source: https://docs.pillsoftware.com/settings/shopify-flow-automations
Set up AddressPill automation events in Shopify Flow for immediate and delayed follow-up actions on address issues.
## Automations settings
Use this tab to integrate AddressPill with Shopify Flow.
## How it works
AddressPill can trigger:
* an **immediate** event when an issue is detected
* a **follow-up** event if the issue is still unresolved later
## How to configure
1. Open **Settings**.
2. Open **Automations**.
3. Open Shopify Flow from the setup card.
4. Build your workflows for immediate and follow-up event handling.
5. Click **Save settings** in AddressPill.
## Typical use cases
* Notify your operations team
* Create internal triage tasks
* Trigger customer communication sequences
## FAQ
### Do I need Shopify Flow for AddressPill automations?
Yes, this settings area is built around Shopify Flow event handling.
### What should I build first in Flow?
Start with one immediate workflow, then add a follow-up workflow for unresolved issues.
### Can automations notify both team and customers?
Yes, you can design flows for internal alerts and customer-facing communication.
# Tag orders
Source: https://docs.pillsoftware.com/settings/tag-orders-by-address-issue
Set AddressPill order tags for different validation outcomes so operations teams can triage problem orders faster.
## Tag orders settings
Use this tab to define which tags AddressPill should apply after post-checkout checks.
## How to configure
1. Open **Settings**.
2. Open **Tag orders**.
3. Set one tag per issue type.
4. Set the generic fallback tag.
5. Click **Save settings**.
## Tag types
* **Missing house number tag**
* **Unconfirmed address tag**
* **Spelling issue tag**
* **Format issue tag**
* **Generic post-checkout issue tag**
## Best practice
Use short, consistent tags (for example: `unconfirmed`, `format`, `spelling`) so filters and automations stay clean.
## FAQ
### Should I use one tag or multiple tags?
Use one clear tag per issue type and one generic fallback for unmatched cases.
### Can tags trigger automations in Shopify?
Yes, consistent tags can be used in Shopify filters and automation flows.
### What are good tag naming patterns?
Keep tags short and standardized, for example `unconfirmed`, `spelling`, and `format`.