If you’re running into issues while using Auto-Pickup Locations (APL) for WooCommerce, don’t worry, most problems are caused by minor configuration errors and can be fixed in minutes.

This guide covers the most common Auto-Pickup Location issues and how to resolve them quickly so your checkout flow continues to work smoothly.

Quick Pre-Check (Before Troubleshooting)

Before diving into specific errors, confirm the following:

• Auto-Pickup Locations is installed and activated.
• Pickup locations are properly added (with correct latitude and longitude).
• The Auto-Pickup Locations shipping method is enabled.
• Your theme or page builder is not overriding the WooCommerce checkout template.
• You’ve cleared caching (plugin, server, and browser cache).

If everything above checks out, use the fixes below.

1. Pickup Location Not Showing at Checkout

Possible causes could be the shipping method not enabled, no pickup locations created, or the customer address not detected.

Solution

1. Go to WooCommerce → Settings → Shipping.→ APL Settings
2. Ensure your Auto-Pickup Locations shipping method is enabled
3. Confirm that at least one pickup location exists.
4. Check that the customer has turned on location and entered a valid address at checkout.

2. Auto-Assign Pickup Location Not Working

Auto-Pickup Location automatically selects the nearest pickup location based on the customer’s location. If it fails:

Possible causes could be incorrect latitude/longitude values, location detection is blocked by the browser, or coordinates are not in decimal format.

Solution

• Verify coordinates are in 15 decimal places (e.g., 6.524358794287653, 3.379356986217648).
• Recheck coordinates using Google Maps.
• Ensure the customer allows location access in their browser.

Precision errors in coordinates are one of the most common causes.

3. Customers Cannot Manually Select Pickup Location

If “Let Customers Choose” is enabled but no dropdown appears:

Possible causes could be that Auto-assign is still active, theme or checkout plugin conflict, JavaScript error.

Solution

1. Disable Auto-Assign in Auto-Pickup Locations settings.
2. Switch temporarily to a default theme to test.
3. Disable other checkout customization plugins one by one.
4. Check the browser console to see if JavaScript is enabled.

4. Limited to 5 Pickup Locations

The free version only supports up to five locations.

Solution

Upgrade to Auto-Pickup Locations PRO to:

• Add unlimited pickup locations.
• Use CSV import.
• Set custom email notifications per pickup location.
• Access premium support.

If you already upgraded but still see limits, confirm the PRO license is activated.

5. CSV Import Failing (PRO)

Possible causes could be incorrect CSV format, missing required columns, or wrong coordinate format.

Solution

• Ensure CSV uses UTF-8 encoding.
• Confirm required fields (name, latitude, longitude).
• Use decimal coordinates only.
• Avoid special characters in headers.

Test by importing one row first before uploading bulk data.

When to Contact Support

If none of the fixes above resolve the issue:

• Test with only WooCommerce and Auto-Pickup Locations active.
• Switch to a default theme.

If the issue persists, PRO users can open a priority support ticket or Contact Support.

Helpful External Resources

• WooCommerce Shipping Documentation
  
• How to Get Accurate Latitude and Longitude from Google Maps

Final Thoughts

Most Auto-Pickup Location issues are related to shipping zones, coordinates, or checkout conflicts. A quick configuration review usually resolves the problem immediately.

If you’re setting up Auto-Pickup Locations for the first time, double-check coordinate accuracy and email settings to ensure a smooth customer experience.

With the right setup, Auto-Pickup Locations provides automated location assignment, flexible manual selection, and streamlined pickup management—making local fulfillment simple and reliable.