See all services Shopify Plus Partner
API Developer

Enable Tax Apps to Receive Line Item Attributes

API update: Tax Partner Apps can now handle custom line item properties like "token" and "personalization" from merchant carts.

Executive summary:

What changed

As of API version 2026-01, Shopify allows Tax Partner Apps to access custom properties of cart line items. These properties are configurable, allowing merchants to specify which attributes, up to a maximum of five, are available to tax apps.

Why it matters

This update enables Shopify Plus merchants to enhance tax accuracy and meet regulatory obligations better. By configuring specific item properties that bear on tax, merchants can potentially reduce computation errors and improve operational efficiency. Additionally, this feature supports unique tax scenarios by taking custom cart attributes into account.

Role-specific impact

Use-case example

Real-world scenario & metric

A merchant sells personalized products and enables "token" and "personalization" attributes for tax calculations. This results in a 10% reduction in tax inaccuracies because each item's unique attributes are considered during tax computation.

Implementation checklist

  1. Identify relevant line item properties for tax calculations.
  2. Configure these properties within the Tax Partner App.
  3. Test tax scenarios using these properties on a sample set of orders.
  4. Review and verify tax outcomes for accuracy.

FAQ

Q: What attributes can we use?
A: Merchants can choose up to five custom attributes like "personalization" or "gift_wrap" for tax calculations.

Q: How does this affect current tax setups?
A: It enhances them by factoring in custom line item data, leading to more accurate tax assessments.

Resources

Explore the Shopify Partner Tax App documentation for detailed guidance.

Need guidance? Talk to Makro.