# Item handling

Configure Stripe-authored scripts to customize item handling behavior.

### Interested in getting early access to Stripe-authored scripts?

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/billing/scripts/stripe-authored/item-handling" \
  -d '{"email": "EMAIL", "preview": "scripts_preview"}'
```

Use the following scripts to customize billing behavior for item handling.

> You’re responsible for making sure your configuration is correct. Stripe doesn’t take responsibility for any issues that arise as a result of your configuration.
> 
> In preview, if customization fails for any reason or causes harm, Stripe reserves the right to default to standard functionality and/or pause subscription processing. To understand the default behavior, see the descriptions of each [available script](https://docs.stripe.com/billing/scripts/stripe-authored.md#use-cases).

## Separate invoice for metered items 

By default, when a subscription contains both metered usage items and licensed items, Stripe puts them all on a single invoice. This script routes them to separate invoices based on the item’s usage type. The invoice with licensed items becomes the latest invoice for the subscription.

Use this script when your finance team needs to reconcile usage charges separately from recurring seat or license fees, or when your customers expect different invoices for them.

### Configuration options 

1. Select **Customize** next to **Item handling**.
2. Select **Separate invoice for metered items**.
3. Select **Save** and confirm activation.

This script has no additional parameters. It automatically routes items based on their usage type.

### Example 

A subscription includes a “Pro Plan” licensed at 20 USD per month and metered API usage totaling 15 USD this billing cycle.

**Default behavior**

One invoice with both items.

- Invoice total: 35 USD (20 USD license + 15 USD usage)

**After activating the script**

Two separate invoices.

- Invoice 1 (licensed): 20 USD for Pro Plan. This invoice becomes the subscription’s latest invoice.
- Invoice 2 (metered): 15 USD for API usage.

To see the change in the Dashboard, go to the subscription detail page and check the **Invoices** tab to see two invoices for the billing period instead of one.

## See also

- [Stripe-authored scripts](https://docs.stripe.com/billing/scripts/stripe-authored.md)
- [Configure a script in the Dashboard](https://docs.stripe.com/billing/scripts/configure.md)
- [Control which items appear on subscription invoices](https://docs.stripe.com/billing/scripts/item-handling.md)