Troubleshooting

Dashboard shows activation only

Confirm the license key is correct, the site can reach https://xcodesol.com/api, the server time is accurate, and no firewall is blocking outbound HTTPS requests. Revalidate the license after fixing connectivity.

Booking form says activation is required

The public booking surface is locked because the local license state is missing, expired, invalid, revoked, or failed validation. Activate or revalidate from the admin dashboard.

No slots appear

Check service duration, buffers, staff assignment, location assignment, working hours, breaks, holidays, existing bookings, capacity, lead time, and future booking window settings.

WooCommerce checkout does not start

Confirm WooCommerce is active, products are synced, the service requires checkout, payment gateways are configured, and checkout pages are assigned in WooCommerce settings.

Emails or reminders do not send

Check WordPress mail delivery, SMTP configuration, notification settings, message templates, cron execution, and background job logs.

REST requests fail

Check the REST namespace xcodesol-beauty/v1, WordPress permalinks, nonces for admin routes, user capabilities, license status, security plugin rules, and server error logs.

Data did not migrate

Visit the admin dashboard as an administrator to trigger migrations. Confirm the database user has table creation and alteration permissions. Back up the database before retrying migrations on production.