Subscriptions Logs

WooCommerce Subscriptions 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 about the cause and repercussions of an issue.

The types of logs you’ll find for WooCommerce Subscriptions are

  • Error Logs – Failed Status Change Logs, Failed Scheduled Action Logs, Failed PayPal IPN logs, and PayPal Logs.
  • Updrade Logs – General notes about upgrades. 
  • Switch Logs – Log that records details about when and how a subscription was upgraded, downgraded, or items switched.
  • PayPal Standard Logs – While not directly created by WooCommerce Subscriptions, it does add certain, related subscription info to them.

Where to find WooCommerce Subscriptions error logs

↑ Back to top

Logs can be found on the WP Admin dashboard of a site. To view the WooCommerce Subscriptions (and other WooCommerce-related) logs:

  1. Go to WooCommerce > Status
  2. Click on the Logs tab
  3. Click on the Source name of a log to view its contents
  4. Or arrange logs by Source, Date created, Date modified, or File size, by clicking the respective column heading.

Log names will begin with wcs- and, like other logs, contain the date it was created, the date it was last updated, and the filesize of the log.

WooCommerce Subscription logs start with "wcs" when viewing the Logs tab under WooCommerce > Status.
WooCommerce Logs Tab

Subscription 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. Failed scheduled actions are recorded here along with 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

Upgrade Logs

↑ Back to top

When WooCommerce Subscriptions updgrades to a new version, for example, from version 6.4.1 to 6.5.0, various bits of information about the upgrade is recorded. The information is stored in a log named wcs-upgrade, and is listed under the WooCommerce > Status > Logs. The upgrade log is generated on the date an upgrade takes place, so multiple logs may exist.

The wcs-upgrade log appears on the list of WooCommerce logs
The wcs-upgrade log appears on the list of WooCommerce logs

General Upgrade Notes Logs

↑ Back to top

This log records deatils about which other plugins and extensions, and their versions, were active at the time of the update. Each log can contain the following:

  • 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
  • Unless an error occured, most of the information is labled as Notice

Example log entry:

An example WooCommerce Subscriptions upgrade log
An example WooCommerce Subscriptions upgrade log

Subscription Switch Logs

↑ Back to top

The Subscription Switch Log records events related to when a customer upgrades, downgrades, or changes their subscriptions. It’s primarily a source of info about what happened to make it easier for the store manger to refer back to, should that be required.

The wcs-switch-cart-items log records the following:

  • A timestamp with the subscription number
  • The canonical product ID of the product involved
  • The unix timestamp for when the next payment is due
  • The unix timestamp for when an associated order was last paid
  • How many days there were in the last subscription cycle
  • How much was paid during the current period
  • The old price-per day
  • Days in the new cycle
  • The new price per day
  • What type of switch occured

Example entry log:

An example WooCommerce switch cart items log
An example WooCommerce switch cart items log

PayPal Standard Logs

↑ Back to top

Support for PayPal Standard is very limited and you might be asked to switch to PayPal Payments if troubleshooting cannot fix reported issues. Since WooCommerce version 5.5.0, PayPal Standard is hidden for new installations. We strongly encourage everyone using PayPal Standard to use the recommended PayPal Payments extension instead, which is our full-stack solution (credit card processing, PayPal checkout, subscriptions, pay later options, etc).

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

Failed PayPal Standard 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