Getting started

Core Features

Store Management

Payments

Developer

My account

The My account page is where customers manage their own subscriptions. Milo Subscriptions integrates with the standard WooCommerce /my-account/ page and adds a Subscriptions section.

What customers see

Logged-in customers see a Subscriptions item in the My account menu. The page lists every subscription the customer has, along with per-subscription detail views reachable via a View button.

Subscription detail

The detail page shows:

  • The product and variation.
  • Current status.
  • Billing cadence and totals.
  • Start date and next payment date.
  • Items on the subscription.
  • Related orders.
  • Context-aware action buttons.

Customer actions

The action buttons visible to a customer depend on the subscription’s status and your settings. The action keys and labels defined in the core plugin include:

  • Suspend (pause the subscription), when Allow customers to suspend is enabled under Subscriptions → Settings → Customer. An optional Maximum suspensions per subscription limits how often a single subscription can be paused.
  • Reactivate (resume from a suspended subscription).
  • Cancel, when Allow customers to cancel is enabled and the Minimum periods requirement has been met.
  • Change payment method.
  • Switch to automatic / Switch to manual (toggles the auto-renewal mode, if the current payment method supports it).
  • Resubscribe, on cancelled and expired subscriptions, starts a new subscription with the same product.

Actions not in the core plugin’s default action set:

  • Switch plan (switching is driven from the product/variation level, not a direct My Account action).
  • Early renew (surfaced when Early renewal is enabled in settings, via its own UI).

Filtering the action list

The canonical filter for customer-facing actions is:

apply_filters( 'milosubscriptions_customer_subscription_actions', $actions, $subscription );

Use it to add, remove, or rename actions. There are no milosubscriptions_myaccount_actions, milosubscriptions_myaccount_subscriptions_columns, or milosubscriptions_myaccount_subscription_summary filters in the core plugin.

Standalone mode

Standalone mode renders its own subscription summary (driven by a block/shortcode pair) rather than piggybacking on the WooCommerce My account menu. Its template is more compact than the WooCommerce version because there is no WooCommerce order history to interleave with.

Templates

My account templates live in wp-content/plugins/milosubscriptions/templates/myaccount/. The files shipped with the plugin are:

  • subscriptions.php: the Subscriptions list.
  • view-subscription.php: the detail view.
  • change-payment-method.php: the change-payment-method flow.
  • cancellation-survey.php: the cancellation survey (if enabled).

To override a template, copy it into yourtheme/milosubscriptions/myaccount/.

Emails

Customer-facing events trigger these emails:

  • Activated subscription (when the subscription becomes active).
  • Customer on-hold.
  • Customer processing renewal.
  • Customer completed renewal.
  • Customer renewal invoice (manual renewals and admin-issued invoices).
  • Customer cancelled.
  • Customer expired.

Permissions and visibility

Customers only see their own subscriptions. This is enforced on the server; direct URL access to another customer’s subscription returns a 404.

Settings

Under Subscriptions → Settings → Customer you can control:

  • Whether customers can suspend (and the suspension cap).
  • Whether customers can cancel (and the minimum periods before cancellation).
  • Whether the cancellation survey is shown and what reasons are offered.

Troubleshooting

A subscription is missing from My account

Confirm the subscription is linked to the correct customer. If created manually by an admin with the wrong customer, edit it to point at the right one.

Buttons are missing

Check that the relevant settings are enabled (Suspend, Cancel, Early renewal, etc.) and that the subscription is in a status that allows the action. Some actions (Change payment method, Switch to automatic/manual) require a gateway that supports saving payment methods.

Next steps