Error Messages

This guide explains common error messages and how to resolve them.

API Errors

"401 Unauthorized"

Meaning: The API credentials are invalid or expired.

Solution:

  1. Go to Settings > Shopify Connection
  2. Verify your Client ID and Secret
  3. If using a custom app, ensure it's installed (not just created)
  4. Generate new credentials if needed

"403 Forbidden"

Meaning: The app doesn't have permission for this operation.

Solution:

  1. Check API scopes in your Shopify custom app
  2. Add the required scopes
  3. Reinstall the app after adding scopes

"404 Not Found"

Meaning: The requested resource (product, collection, etc.) doesn't exist.

Causes:

  • Product was deleted in Shopify
  • Invalid product ID
  • Store name is incorrect

Solution:

  1. Refresh your product list
  2. Verify the resource exists in Shopify admin

"429 Too Many Requests"

Meaning: Shopify API rate limit exceeded.

Solution:

  1. Wait 1-2 minutes
  2. Reduce batch size in Settings
  3. Avoid multiple simultaneous operations

"500 Internal Server Error"

Meaning: Shopify server error.

Solution:

  1. Wait and retry
  2. Check Shopify Status
  3. If persistent, contact Shopify support

Validation Errors

"Title cannot be empty"

Solution: Enter a product title before saving.

"Price must be a positive number"

Solution: Enter a valid price (e.g., 19.99, not -5 or "abc").

"Inventory must be a whole number"

Solution: Enter an integer for inventory (e.g., 100, not 100.5).

"SKU already exists"

Solution: Choose a unique SKU for this variant.

File Errors

"File not found"

Cause: The selected file was moved, renamed, or deleted.

Solution: Browse for the file again.

"File is in use by another program"

Solution:

  1. Close other programs using the file
  2. Close Excel if file is open
  3. Try again

"Invalid file format"

Solution:

  1. Ensure file is a supported format (CSV, XLSX)
  2. Check file isn't corrupted
  3. Try saving as CSV from Excel

Network Errors

"Network connection lost"

Solution:

  1. Check your internet connection
  2. Restart your router if needed
  3. Try again when connected

"Request timed out"

Causes:

  • Slow internet connection
  • Shopify server busy
  • Large data transfer

Solution:

  1. Wait and retry
  2. Try during off-peak hours
  3. Reduce batch size in Settings

"SSL/TLS error"

Solution:

  1. Check system date/time is correct
  2. Update Windows
  3. Check firewall/antivirus settings

Database Errors

"Database is locked"

Cause: Another instance of ProductManager is running.

Solution:

  1. Close all ProductManager windows
  2. Check Task Manager for running instances
  3. Restart the application

"Database corrupted"

Solution:

  1. Go to Settings > Advanced > Repair Database
  2. If that fails, clear cache (File > Clear Cache)

Application Errors

"Unexpected error occurred"

Solution:

  1. Note the error message
  2. Check the log file in %LocalAppData%\HFProductManager\Logs
  3. Restart the application
  4. If persistent, report the issue with the log file

"Out of memory"

Solution:

  1. Close other applications
  2. Reduce visible products using filters
  3. Clear cache and restart
  4. Consider adding more RAM if this happens frequently

"XamlParseException: Cannot find resource"

Meaning: A UI resource (style, template, etc.) wasn't loaded correctly.

Solution:

  1. Restart ProductManager
  2. If persistent, reinstall the application
  3. Check the log file for the specific resource name

"WebView2 initialization failed"

Meaning: The description editor's preview component couldn't start.

Solution:

  1. Install Microsoft Edge WebView2 Runtime from Microsoft
  2. Restart ProductManager
  3. Check Windows Updates for Edge components

"Product has been modified externally"

Meaning: The product was changed in Shopify while you had it open.

Solution:

  1. Click Refresh to load the latest version
  2. Re-apply your changes
  3. Save again

"Some products failed to sync"

Meaning: One or more products couldn't be synced to Shopify.

Solution:

  1. Check the sync log for specific errors
  2. Common causes: deleted products, API limits, permission issues
  3. Retry failed products individually

"License validation failed"

Meaning: Your license couldn't be verified.

Solution:

  1. Check your license key is entered correctly
  2. Verify your subscription is active
  3. Check internet connectivity
  4. Contact support if the issue persists

"No products selected"

Meaning: A bulk operation requires products to be selected first.

Solution:

  1. Click on one or more products in the grid
  2. Use Ctrl+A to select all
  3. Retry the operation

"Settings not saving"

Meaning: The settings file couldn't be written.

Solution:

  1. Check write permissions to %AppData%\HFProductManager
  2. Ensure the disk isn't full
  3. Try running as administrator once
  4. Verify no antivirus is blocking the write

Contacting Support

When reporting an error:

  1. Copy the full error message
  2. Note what you were doing when it occurred
  3. Include the log file from %AppData%\HFProductManager\Logs
  4. Mention your ProductManager version (Help > About)