Shipping addresses

Shipping addresses let you associate a physical delivery address with each subscription on a customer account. When a subscription has a shipping address, that address appears on the invoice and is used for tax calculations — ensuring the right taxes are applied based on where goods are delivered.

Available on all Recurly plans

1Definition 2Key details

Limitations

Customers cannot manage their own shipping addresses through Checkout, Hosted Payment Pages, or Hosted Account Management — shipping addresses must be managed by admins via the Admin UI or the API

Definition

Recurly's shipping addresses feature lets businesses associate and manage physical delivery addresses with individual subscriptions. Each account supports up to 20 distinct shipping addresses, and different addresses can be assigned to different subscriptions on the same account. When a subscription is linked to a shipping address, that address is displayed on the invoice and used as the basis for tax calculations.

Key details

Managing shipping addresses

Shipping addresses are managed from the account detail page in the Admin UI.

Open the account detail page

Navigate to the customer's account in the Admin UI and click Manage addresses.

Create, edit, or delete an address

From the Manage addresses page, create a new shipping address or find an existing one to edit or delete.

Associate the address with a subscription

Open the subscription detail page and link the shipping address to that subscription.

Once associated, the shipping address appears on all invoices for that subscription and is used for tax calculations where applicable.

Shipping addresses can also be managed programmatically via the Recurly API. For endpoint details, see the API documentation.

Activity log

All changes to shipping addresses are recorded in the Activity Log of the customer account, providing a full audit trail of any additions, edits, or deletions.

Email parameters

The following parameters are available to include shipping address details in Recurly email templates:

Parameter	Description
`{{subscription_has_shipping_address?}}`	Returns `true` if the subscription has a shipping address.
`{{subscription_shipping_nickname}}`	The nickname assigned to the shipping address.
`{{subscription_shipping_first_name}}`	First name on the shipping address.
`{{subscription_shipping_last_name}}`	Last name on the shipping address.
`{{subscription_shipping_address1}}`	Street address line 1.
`{{subscription_shipping_address2}}`	Street address line 2.
`{{subscription_shipping_city}}`	City.
`{{subscription_shipping_state}}`	State or province.
`{{subscription_shipping_zip}}`	Postal / ZIP code.
`{{subscription_shipping_country}}`	Country.
`{{subscription_shipping_phone}}`	Phone number on the shipping address.
`{{subscription_shipping_email}}`	Email address associated with the shipping address.
`{{subscription_shipping_vat_number}}`	VAT number on the shipping address.
`{{subscription_full_shipping_address}}`	Full formatted shipping address as a single string.