Troubleshooting

Running into an issue with your Shop Craft store? You're in the right place. This section covers the most common problems and their solutions.

Quick Links

Guide	What It Covers
Common Issues	Blank pages, 500 errors, payment failures, upload problems, and email issues
Cron / Scheduler Setup	Setting up automatic background tasks like license verification
Getting Support	How to contact the Shop Craft team and what information to include

Before You Troubleshoot

Here are a few quick checks that resolve most issues:

1. Check That Your Domain Points to public/

The most common issue after installation is the domain pointing to the wrong folder. Your domain must point to the public/ folder inside your Shop Craft directory — not the root directory.

2. Check File Permissions

Make sure the storage/ and bootstrap/cache/ folders are writable (permission 755 or 775). See File Permissions for a step-by-step guide.

3. Check the Error Log

Most errors are logged in the file storage/logs/laravel.log. You can view this file using cPanel's File Manager. The most recent errors appear at the bottom of the file.

How to View the Error Log

1. Open cPanel > File Manager
2. Navigate to your Shop Craft directory > storage > logs
3. Click on laravel.log and select View or Edit
4. Scroll to the bottom to see the most recent errors

4. Verify PHP Version and Extensions

Make sure your server is running PHP 8.1 or higher with all required extensions. You can check this in cPanel under Select PHP Version.

---

If these quick checks don't resolve your issue, check the specific guides linked above or contact support.