Solutions to common issues you might encounter while using FirearmCart. Find your issue below and follow the steps to resolve it.
Store & Access Issues
Can’t Log In
Symptoms: Unable to access your FirearmCart admin
Solutions:
-
Verify credentials
- Check email address is correct
- Check caps lock isn’t on
- Try typing password in a text editor first
-
Reset password
- Click “Forgot password” on login page
- Check email (including spam folder)
- Follow reset link
-
Two-factor authentication issues
- Make sure your phone sets its time automatically: authenticator codes depend on it
- Lost your authenticator app? On the Two-factor verification screen, choose Use a recovery code and enter one of the recovery codes you saved when you turned on two-factor
- Contact support if you’re still locked out
-
Too many attempts
- Login is limited to 5 attempts per minute
- Wait a minute and try again
- Contact support if you still can’t get in
Store Not Loading
Symptoms: Your storefront shows error or blank page
Solutions:
| Issue | Solution |
|---|---|
| Blank page | Check theme is published |
| Error message | Note error, check logs |
| Slow loading | Check for large images |
| SSL error | Verify domain settings |
Steps to diagnose:
- Try accessing in incognito/private mode
- Try a different browser
- Check if admin panel loads
- Review recent changes made
- Contact support with details
Customers See a Security Check Before the Store Opens
Symptoms: A customer sees a short “Performing security verification” page before your store loads
Store domains run an automatic browser check to keep bots from slowing your store down. Most browsers pass in a few seconds without a click, and the check doesn’t come back on every page.
Who sees it:
| Visitor | When |
|---|---|
| Outside the US | On their first page. They can still shop once they pass |
| Opening a filtered collection link directly | Only if it’s their first page on your store, for example from a bookmark or a shared link |
Search engines and social media link previews skip the check. So do your marketplace feeds, sitemaps and images.
If a customer gets stuck on the check:
- Wait a few seconds, and tick the box if one appears
- Turn on JavaScript and cookies for your store
- Turn off any VPN or private proxy
- Contact support with the customer’s location and the page address if it still doesn’t open
Can’t Add Items to the Cart
Symptoms: Products won’t go into the cart on your storefront
Solutions:
-
Shop on your own domain
- The cart and checkout only work on a connected domain
- Your store’s FirearmCart address (
my.firearmcart.com/and your store’s ID) and theme previews are for previewing, so customers can’t add to the cart there - If your domain isn’t connected yet, see Custom Domains
-
Get past the password page
- While Password protection is on, visitors to your domain see a password page instead of the store
- Enter your Store password, from the Storefront access card under Settings → General, to shop the store yourself
- Turn Password protection off when you’re ready to open the store to everyone. See Going Live
-
Still stuck? Contact support with the product, the page address and what happens when you add it to the cart
Admin Panel Slow
Symptoms: FirearmCart admin is loading slowly
Solutions:
-
Browser issues
- Clear browser cache
- Disable browser extensions
- Try different browser
-
Network issues
- Check internet connection
- Try different network
- Verify not using VPN that slows connection
-
System issues
- Check the status page at status.firearmcart.com
- Report if issue persists
Product Issues
Products Not Appearing on Store
Symptoms: Products visible in admin but not on storefront
Solutions:
| Check | Solution |
|---|---|
| Status | Ensure product status is Active, not Draft |
| Inventory | Verify stock quantity > 0 if “Track quantity” is on |
| Out of stock | Enable “Continue selling when out of stock” to keep it listed at zero stock |
| Collections | Ensure product is in a visible collection |
| Pricing | Confirm price is set |
Steps:
- Open the product in admin
- Set Status to Active
- Check inventory settings
- Save and refresh the storefront
Images Not Uploading
Symptoms: Product images fail to upload
Solutions:
| Issue | Solution |
|---|---|
| File too large | Product and variant images must be under 5MB. Files uploaded to the file library and collection galleries can be up to 10MB. Store logo, checkout logo, and favicon must be under 1MB |
| Wrong format | Use a standard image format such as JPEG, PNG, GIF, or WebP. Animated WebP images can’t be used |
| Slow connection | Wait for upload to complete |
| Browser issue | Try different browser |
Best practices:
- Optimize images before upload
- Use JPEG for photos (smaller size)
- Use PNG for graphics with transparency
- Recommended: 2048x2048px maximum
Inventory Not Syncing
Symptoms: Inventory levels not updating from distributor
Solutions:
-
Check plugin status
- Navigate to Plugins and open the distributor
- Verify the connection is active
- Check last sync timestamp
-
Re-sync manually
- Click “Sync now” on integration
- Wait for sync to complete
- Check for error messages
-
Verify credentials
- API credentials may have expired
- Re-enter credentials
- Test connection
-
Check distributor status
- Distributor API may be down
- Check distributor’s status page
- Try again later
Remember that distributor catalogs sync on a schedule set by your plan — every 12 hours on Starter, every 6 hours on Growth, and hourly on Pro — so a change at the distributor won’t appear instantly.
Product Variants Not Working
Symptoms: Variants not displaying or pricing incorrectly
Solutions:
-
Check variant configuration
- Each variant needs price set
- Each variant needs inventory
- Options must be properly defined
-
Display issues
- Check theme supports variants
- Clear cache
- Test in incognito mode
Order Issues
Payment Not Processing
Symptoms: Customers unable to complete checkout
Solutions:
| Error | Cause | Solution |
|---|---|---|
| Card declined | Customer’s bank issue | Customer contacts bank |
| Gateway error | Processor connection issue | Check API credentials |
| Timeout | Slow connection | Customer retry |
| Not configured | Missing payment setup | Complete payment setup |
Steps to diagnose:
- Check Settings > Payments for status
- Verify payment processor connection
- Review recent transactions for patterns
- Check processor dashboard for errors
- Test with a small transaction
Order Stuck in Processing
Symptoms: Order not moving to next status
Solutions:
-
Payment pending
- Check if payment completed
- View transaction in processor dashboard
- Mark paid manually if confirmed
-
FFL selection needed
- Firearm order awaiting FFL
- Contact customer for FFL selection
- Customer selects FFL in their account
-
Manual review required
- Check order flags
- Review for fraud indicators
- Approve or cancel as appropriate
Can’t Fulfill Order
Symptoms: Fulfill button not working or error when fulfilling
Solutions:
| Issue | Solution |
|---|---|
| No items to fulfill | Already fulfilled |
| Missing shipping info | Edit order, add address |
| Carrier error | Check shipping integration |
| Out of stock | Restock or cancel items |
Customer Didn’t Receive Order Confirmation
Symptoms: Customer says they didn’t get email
Solutions:
-
Verify email address
- Check for typos in order
- Confirm email is correct
-
Check spam folder
- Ask customer to check spam/junk
- Add your domain to safe senders
-
Resend the confirmation
- Open the order
- Open the actions menu and choose Resend Emails > Order Confirmation
- Confirm the email was sent
Refund confirmations and tracking emails can be resent the same way.
-
Email deliverability
- Check email settings
- Verify sender domain
- Review email logs
Payment Issues
Refund Failed
Symptoms: Error when processing refund
Solutions:
| Error | Cause | Solution |
|---|---|---|
| Exceeds original | Refunding more than paid | Check amount |
| Already refunded | Duplicate refund attempt | Review refund history |
| This payment hasn’t settled yet | Authorize.net refunds a payment only after it settles, once a day at your cut-off time | Refund it after it settles, or void it to cancel the whole payment. See Refunding an Authorize.net payment that hasn’t settled |
| Processor error | Gateway issue | Retry or check processor |
| Card expired | Original card no longer valid | Issue store credit |
Steps:
- Verify refund amount is correct
- Check previous refunds on order
- Confirm with payment processor
- Try again or use alternative method
Payment Processor Disconnected
Symptoms: Payments failing, processor shows disconnected
Solutions:
-
Re-authenticate
- Navigate to Settings > Payments
- Click on processor
- Re-enter credentials
- Test connection
-
Check credentials
- Verify API key hasn’t expired
- Confirm credentials match processor dashboard
- Generate new keys if needed
-
Processor account issue
- Check processor dashboard for alerts
- Verify account is in good standing
- Contact processor support
Transaction Fees Seem Wrong
Symptoms: Fees higher than expected
Solutions:
-
Review rate schedule
- Check contract with processor
- Verify rate tier
- International cards often higher
-
Check transaction types
- Card-present vs card-not-present
- Debit vs credit
- Rewards cards
-
Contact processor
- Request fee breakdown
- Ask about rate optimization
- Review recent statements
Shipping Issues
Shipping Rates Not Showing
Symptoms: Checkout shows no shipping options
Solutions:
| Check | Solution |
|---|---|
| Shipping zones | Ensure customer’s location is covered |
| Rates configured | Add rates to zones |
| Product weight | Ensure products have weights: filter the Products list by Weight > Missing weight |
| Shipping profiles | Check profile assignments |
Steps:
- Navigate to Settings > Shipping
- Review shipping zones
- Confirm customer’s location is in a zone
- Check rates exist for that zone
- Verify products have shipping weights
Wrong Shipping Rates
Symptoms: Rates too high or too low
Solutions:
-
Check product weights
- Filter the Products list by Weight > Missing weight to find products without one
- Open affected products
- Verify weight is accurate
- Update if incorrect
-
Check product dimensions
- Dimensional weight may apply
- Update package dimensions
- Use actual dimensions
-
Review rate configuration
- Check rate calculation method
- Verify carrier rates are current
- Test with known dimensions
Printify Orders or Catalog Not Syncing
Symptoms: Shop products missing from Plugins > Printify, or orders not appearing in Printify
Solutions:
-
Check the connection
- Open Plugins > Printify
- Use Test Connection
- Printify tokens expire after one year — paste a new token from the marketplace if the current one is rejected
-
Check the shop catalog
- FirearmCart only lists products already published in the connected Printify shop
- Use Resync now from the Sync info (ⓘ) menu
-
Check fulfillment
- Confirm the fulfillment is routed to Printify and has been processed
- If Hold production is on, the order is in Printify on hold until you release it
-
Check tracking webhooks
- Click Re-register webhooks
- Tracking is also polled every four hours if a webhook is missed
See Printify for the full setup and troubleshooting guide.
ShipStation Not Syncing Orders
Symptoms: Orders not appearing in ShipStation
Solutions:
-
Check connection status
- Navigate to Plugins > ShipStation
- Verify the connection is active
-
Check sync settings
- Verify order types selected
- Check status filters
- Confirm store is selected
-
Re-authorize
- Disconnect ShipStation
- Reconnect with fresh authorization
- Test sync
-
Check ShipStation
- Verify store appears in ShipStation
- Check ShipStation logs
- Contact ShipStation support
Theme Issues
Theme Changes Not Appearing
Symptoms: Changes made but not visible on storefront
Solutions:
| Issue | Solution |
|---|---|
| Not published | Publish the theme, or make sure you edited the published one |
| Storefront cache | Clear the theme cache, or turn on Developer Mode to bypass it |
| Browser cache | Clear your browser cache |
| Wrong theme | Verify you’re editing the live theme |
Steps:
- Confirm you’re editing the live theme
- Click “Save” after making changes
- Clear the theme cache from Store > My Store, or enable Developer Mode
- Clear browser cache (Ctrl+Shift+Delete)
- View in incognito mode
Visual Editor Not Loading
Symptoms: Editor shows blank or error
Solutions:
-
Browser issues
- Clear cache and cookies
- Disable browser extensions
- Try different browser
-
Theme issues
- Check theme for Liquid errors
- Revert recent code changes
- Reset to default theme temporarily
-
Connection issues
- Check internet connection
- Try different network
- Retry in a few minutes
Developer Mode Turned Itself Off
Symptoms: Storefront edits stopped appearing immediately again
What’s happening:
Developer Mode bypasses the storefront cache for a set window — 30 minutes, 2 hours, or 8 hours — and switches off automatically when that window ends. Your code changes are not affected. Nothing is reverted, unpublished, or lost; the storefront simply goes back to serving cached pages.
Solutions:
- Re-enable Developer Mode from Store > My Store and pick a longer window
- Or clear the theme cache once, instead of leaving the bypass on
Recovering a Theme File
Symptoms: A code change broke something and you want the previous version back
Solutions:
Every save in the code editor is versioned. Open the file, click Version history, pick an earlier version and click Restore, then click Save to keep it. Nothing changes until you save. See Version History.
Integration Issues
Distributor Integration Not Working
Symptoms: Products not syncing from Lipseys, RSR or MGE Wholesale
Solutions:
-
Check credentials
- Verify API credentials are current (MGE Wholesale uses its FTP username and password)
- Some credentials expire periodically
- Generate new credentials if needed
-
Check permissions
- Verify API access is enabled on distributor side
- Confirm account has necessary permissions
- Contact distributor for access issues
-
Check sync settings
- Review what’s configured to sync
- Try manual sync
- Check error logs
-
Distributor status
- Check if distributor API is operational
- Review any maintenance notices
- Try again during business hours
- MGE Wholesale doesn’t acknowledge orders straight away, so check the fulfillment timeline before you Reship
Duplicate Products After Sync
Symptoms: Same products appear multiple times
Solutions:
-
SKU matching
- Ensure SKUs are unique
- Check if products existed before sync
- Use SKU matching instead of title
-
Clean up duplicates
- Identify duplicate products
- Delete extras (keep one)
- Re-sync with correct settings
-
Prevent future duplicates
- Configure proper matching fields
- Use distributor SKUs
- Don’t mix manual and synced products
Performance Issues
Store Loading Slowly
Symptoms: Pages take long time to load
Solutions:
| Issue | Solution |
|---|---|
| Large images | Compress and resize images |
| Too many products | Paginate or filter collections |
| Complex theme | Simplify customizations |
| Many apps/scripts | Remove unused integrations |
Optimization steps:
- Run speed test (Google PageSpeed)
- Identify largest resources
- Compress images under 500KB
- Limit products per page to 24
- Remove unused code
Admin Panel Timing Out
Symptoms: Admin operations fail or take too long
Solutions:
-
Large operations
- Break bulk operations into smaller batches
- Import fewer products at once
- Export in date ranges
-
Browser issues
- Clear cache
- Use fewer browser tabs
- Close other applications
-
Network issues
- Check connection stability
- Try wired instead of WiFi
- Avoid VPN if possible
Error Messages
Common Error Codes
| Error | Meaning | Solution |
|---|---|---|
| 404 | Page not found | Check URL, verify page exists. If you changed a URL, add a redirect |
| 419 | Page session expired | Refresh the page and resubmit the form |
| 500 | Server error | Refresh, contact support if persists |
| 503 | Service unavailable | Wait and retry |
| Gateway timeout | Request took too long | Retry, simplify request |
| Rate limited | Too many requests | The API allows 60 requests per minute. Wait a minute and retry |
“Something Went Wrong”
Symptoms: Generic error message
Solutions:
-
Try again
- Wait a few seconds
- Retry the operation
- Often temporary
-
Clear cache
- Clear browser cache
- Try incognito mode
- Try different browser
-
Note details
- When did it occur?
- What were you doing?
- Is it reproducible?
-
Contact support
- Provide error details
- Include screenshots
- Describe steps to reproduce
“Session Expired”
Symptoms: Logged out unexpectedly
Solutions:
-
Log back in
- Normal after about two hours of inactivity
- Re-enter credentials
-
Browser settings
- Ensure cookies are enabled
- Don’t use “never remember” settings
- Disable aggressive privacy extensions
-
Frequent expiration
- Check for conflicting sessions
- Verify 2FA time sync
- Contact support if persists
“This Page Has Expired”
Symptoms: A page you left open asks you to refresh it, and what you just did there wasn’t saved
You moved to another store after that page loaded, in another tab or on another device. You work in one store at a time, so FirearmCart won’t save from a page still showing a different store, which would overwrite the store you’re in now.
When you switch stores, your other open tabs normally move to the new store’s dashboard on their own, and any unsaved changes in them are lost. A page only shows this message if it missed that, for example after your computer was asleep.
Solutions:
-
Refresh the page
- Click OK to reload the page for the store you’re in now
-
Go back to the other store if that’s where you meant to work
- Switch stores, then make your change again
Getting More Help
Before Contacting Support
Gather this information:
- Account email
- Store URL
- Error messages (exact text or screenshot)
- Steps to reproduce
- When it started
- What you’ve already tried
Useful Information to Include
| Type | Details |
|---|---|
| Browser | Chrome, Firefox, Safari, Edge + version |
| Device | Desktop, laptop, tablet, phone |
| Operating system | Windows, Mac, iOS, Android |
| Screenshots | Error messages, unexpected behavior |
| Timeline | When did issue start |
Contact Options
See Contact Us for all support channels and response times.
Related Documentation
- FAQ - Frequently asked questions
- Contact Us - Get support
- Getting Started - Setup guide

