1. Documentation /
  2. Subscriptions Logs

Subscriptions Logs

The Woo Subscriptions extension creates a number of WooCommerce logs to record errors and other events. Recording these events can be important, especially when an issue occurs and the cause must be investigated. These logs record histories of different events that can provide clues as to the cause and repercussions of an issue. The types of logs you’ll find for Woo Subscriptions are: Error Logs, which include: Failed Status Change Logs, Failed Scheduled Action Logs, Failed PayPal IPN logs, and PayPal Logs and Update Logs which include the General Update Notes Log.  Below is a list of these logs that the subscription functionality create and modify. Logs can be found on the dashboard of a site. To view the logs:
  1. Go to WooCommerce > Status
  2. Click on the Logs tab
  3. Choose a log from the drop-down
Log names will begin with the given labels, but will sometimes then have a date and a string of letters and numbers, called a hash, added to them. This is to ensure that each log has a unique name and is not overwritten.
WooCommerce Logs Tab

Error Logs

↑ Back to top

Failed Status Change Logs

↑ Back to top
This log is labeled wcs-update-status-failures. This log records when there has been an error when updating the status of a subscription. Example log entry:
Failed Status Change Log Example

Failed Scheduled Action Logs

↑ Back to top
This log is labeled failed-scheduled-actions. This log records when a scheduled action has failed. It will contain information such as the scheduled action’s name and ID, how long it was attempted, and the arguments. Example log entry:
Failed Scheduled Action Log Example

Failed PayPal IPN Logs

↑ Back to top
This labeled wcs-ipn-failures. This log records fatal errors that occur while a PayPal IPN is being processed when using PayPal with the Woo Subscriptions extension. These error messages will contain info such as a stack trace for where the error occurred. Example log entry:
Failed PayPal IPN Log Example

PayPal Logs

↑ Back to top
This log is labeled paypal. Subscriptions does not generate this log—it’s created by WooCommerce core—but it adds to it. This log records PayPal Standard IPNs, the actions taken with them, and errors. Example log entry:
PayPal Log Example

Upgrade Logs

↑ Back to top
When subscriptions code base is upgraded to a new version, for example, from version 2.4.7 to 2.5.0, it records some information about the upgrade process in a variety of logs.

General Upgrade Notes Logs

↑ Back to top
This log records during upgrades and contains:
  • Timestamp of when the upgrade occurred
  • Version of Subscriptions being updated to
  • Old version of Subscriptions updated from
  • WooCommerce version during this upgrade
  • WooCommerce database version
  • Environment info, which includes WordPress version
  • Info about active plugins, such as name, author, and version
The information in this log is automatically deleted after eight weeks. This log is labeled wcs-upgrade. Example log entry:
Upgrade Log Example
Upgrade Log Example