Subscriptions Logs

WooCommerce Subscriptions creates a variety of WooCommerce logs to record errors and other events. Recording these events can be important, especially when an issue occurs and the cause needs investigation. 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.
• Upgrade 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.

You can find the subscription logs 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.

The following sections explain the different types of Subscriptions error logs you’ll find in WooCommerce > Status Logs.

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:

This log has a failed-scheduled-actions label. 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:

When WooCommerce Subscriptions updgrades to a new version, for example, from version 6.4.1 to 6.5.0, the logs record various bits of information about the upgrade. 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.

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
• The version number for the Subscriptions update
• 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
• Most of the information has a Notice label, unless an error occurs.

Example log entry:

The Subscription Switch Log records events related to when a customer upgrades, downgrades, or changes their subscriptions. This is a primarily a source of information for store managers to refer back to if an error occurs or they need to track down information about the switch.

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:

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:

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: