Enable Tax Apps to Receive Line Item Attributes

Executive summary:

• Tax Partner Apps can receive cart line item properties.
• Enhances customization by using specific item traits.
• Merchants configure which properties to share.

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

• Marketers: Leverage line item properties to create personalized promotions that reflect in accurate tax calculations.
• Developers: Implement property selectors in Tax Partner Apps to facilitate precise tax computation.
• Store admins: Configure and manage product attributes and ensure they align with tax strategy.

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.