Adds invoice description, footer, and custom fields to the Subscriptions API
What’s new
The description, footer, and custom_fields parameters are now available on the invoice_settings hash when you create or update a Subscription. These properties are also returned when you retrieve a Subscription. Previously, these fields were configurable exclusively in the Stripe Dashboard.
Impact
You can now programmatically control the description, footer, and custom fields that appear on every invoice generated by a subscription without needing to update each invoice individually. This is useful for adding information such as PO numbers, contract references, or other reconciliation details at the subscription level. See the subscription invoices documentation for more details.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| custom_fields description footer | Added | Subscription#create. invoice_settings Subscription#update. invoice_settings Subscription. invoice_settings |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-06-24. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.