Testing Your Setup
Ensure everything works perfectly before going live with comprehensive testing.
Testing Overview
A thorough testing process covers:
- Display testing - Options appear correctly
- Functionality testing - Selections work properly
- Cart testing - Items add to cart correctly
- Checkout testing - Complete purchase flow works
- Order testing - Order data is accurate
Pre-Testing Checklist
Before you start testing, ensure:
- ☐ Uplift app is installed
- ☐ App block is added to theme
- ☐ At least one add-on group created
- ☐ Group assigned to at least one product
- ☐ Test products are active/published
Display Testing
Basic Display Check
- Visit a product page with add-on groups assigned
- Verify the options section appears
- Check group titles display correctly
- Confirm all options are visible
- Verify styling matches your theme
Swatch Display
- ☐ Color swatches show correct colors
- ☐ Image swatches load properly
- ☐ Swatch size is appropriate
- ☐ Selection indicator is visible
- ☐ Labels display as configured
Responsive Display
Test on multiple screen sizes:
| Device | What to Check |
|---|---|
| Desktop | Full layout, spacing, alignment |
| Tablet | Layout adapts, touch targets adequate |
| Mobile | Options readable, touch-friendly |
Functionality Testing
Selection Behavior
- ☐ Click/tap selects option
- ☐ Selection is visually indicated
- ☐ Single-select prevents multiple (radio/swatches)
- ☐ Multi-select allows multiple (checkboxes)
- ☐ Dropdown opens and allows selection
Pricing Updates
- Select an option with a linked product
- Verify price updates in real-time
- Check price format is correct
- Test multiple selections
- Verify total calculation
Conditional Logic
If you have conditional rules:
- ☐ Trigger option shows target correctly
- ☐ Deselecting trigger hides target
- ☐ Hidden options don't affect price
- ☐ Multiple conditions work together
Canvas Testing
If using visual preview:
- ☐ Canvas loads initially
- ☐ Layers change on selection
- ☐ Layers align correctly
- ☐ Performance is acceptable
- ☐ Works on mobile
Cart Testing
Add to Cart Process
- Make selections on product page
- Click Add to Cart
- Navigate to cart page
- Verify:
- Main product appears
- Add-on products appear as separate items
- Properties show selections
- Prices are correct
Cart Page Display
- ☐ Line items are clearly labeled
- ☐ Customization details visible
- ☐ Prices are accurate
- ☐ Cart total is correct
- ☐ Quantity changes work (if applicable)
Mini Cart/Drawer Cart
If your theme uses AJAX cart:
- ☐ Products add without page reload
- ☐ All items appear in drawer/mini cart
- ☐ Properties display correctly
Checkout Testing
⚠️ Important: Use Shopify's test mode or Bogus Gateway for checkout testing to avoid real charges.
Full Checkout Flow
- Add customized product to cart
- Proceed to checkout
- Verify items in checkout summary
- Complete test payment
- Check confirmation page
- Verify confirmation email
Verification Points
- ☐ All items appear in checkout
- ☐ Prices match cart
- ☐ Properties shown in line items
- ☐ Order confirmation is correct
- ☐ Email includes customization details
Order Testing
Order Verification
- Open the test order in Shopify admin
- Verify all line items present
- Check properties are recorded
- Confirm hidden properties (underscore) exist
- Verify pricing is correct
Order Checklist
- ☐ Main product with correct variant
- ☐ Visible properties show selections
- ☐ Add-on products as separate line items
- ☐ Prices match what was displayed
- ☐ Inventory decremented correctly
Browser Testing
Test in multiple browsers:
| Browser | Priority |
|---|---|
| Chrome | High (most common) |
| Safari | High (especially mobile) |
| Firefox | Medium |
| Edge | Medium |
| Mobile Safari | High |
| Mobile Chrome | High |
Edge Case Testing
Inventory Scenarios
- ☐ Add-on product out of stock behavior
- ☐ Main product out of stock behavior
- ☐ Low stock warnings if configured
Validation Scenarios
- ☐ Required option not selected
- ☐ Min/max selection limits
- ☐ Error messages display properly
Special Cases
- ☐ Product with no add-on groups
- ☐ Multiple products in cart (some with add-ons)
- ☐ Discount codes with add-on products
Setting Up Test Mode
Bogus Gateway (Recommended)
- Go to Settings → Payments
- Add (for testing) Bogus Gateway
- Use test card numbers during checkout
- Complete test orders without real charges
Shopify Payments Test Mode
- Go to Settings → Payments
- Click Manage on Shopify Payments
- Enable Test mode
- Use Shopify's test card numbers
Complete Testing Checklist
Display
- ☐ Options appear on product page
- ☐ Styling matches theme
- ☐ Responsive on all devices
- ☐ All browsers work
Functionality
- ☐ Selections work correctly
- ☐ Prices update in real-time
- ☐ Conditional logic functions
- ☐ Canvas updates (if used)
Cart & Checkout
- ☐ Add to cart works
- ☐ Cart displays correctly
- ☐ Checkout completes successfully
- ☐ Order is accurate
Next Steps
- Troubleshooting Guide - Fix any issues found
- Best Practices - Optimize your setup
- FAQ - Common questions