Authentified Docs

Appearance

Changelog ​

@authentified/react-widget ​

3.0.0 ​

Major Changes ​

  • Split the old type prop into two orthogonal concepts and require scope to be specified explicitly.

    Why we've done this ​

    The previous type prop conflated two things: how a shop integrates with Authentified (Shopify App vs REST API) and what's being consigned (a line item, a whole order, or a POS / in-person sale). These need to vary independently — a Shopify App shop can sell offline, and a REST API shop can sell online. Splitting them makes the contract honest and removes the implicit "type=offline only works with variantId" rule.

    BREAKING CHANGES ​

    • The type prop has been removed. Replace it with two new props:
      • source: "shopify" | "api" — how the shop integrates with Authentified (defaults to "shopify").
      • scope: "lineItem" | "order" | "offline" — what's being consigned. scope is now required — there is no default.
    • Identifier rules (depend on scope only — source no longer affects which IDs are required):
      • scope="lineItem" → orderId and lineItemId required.
      • scope="order" → orderId required.
      • scope="offline" → orderId (your POS / receipt reference) and variantId required.
    • The exported AuthentifiedButtonOrderType type has been replaced by AuthentifiedButtonSource. AuthentifiedButtonScope now also includes "offline".
    • The internal AuthentifiedLineItemButton export has been removed; use AuthentifiedButton with scope="lineItem".

    Migration ​

    diff
    - <AuthentifiedButton type="shopify" lineItemId={...} productId={...} orderId={...} customerId={...} shopId={...} />
+ <AuthentifiedButton scope="lineItem" source="shopify" lineItemId={...} productId={...} orderId={...} customerId={...} shopId={...} />

- <AuthentifiedButton type="api" variantId={...} productId={...} orderId={...} customerId={...} shopId={...} />
+ <AuthentifiedButton scope="lineItem" source="api" lineItemId={...} productId={...} orderId={...} customerId={...} shopId={...} />

- <AuthentifiedButton type="offline" variantId={...} productId={...} orderId={...} customerId={...} shopId={...} />
+ <AuthentifiedButton scope="offline" variantId={...} productId={...} orderId={...} customerId={...} shopId={...} />

- <AuthentifiedButton type="shopify" scope="order" orderId={...} customerId={...} shopId={...} />
+ <AuthentifiedButton scope="order" orderId={...} customerId={...} shopId={...} />

2.2.0 ​

Minor Changes ​

  • 5a131f155: Change base URL for sold items

2.1.0 ​

Minor Changes ​

  • fd320d7: Change base URL for sold items
  • 63b5642: Fix incorrect URL on sold button

2.0.1 ​

Major Changes ​

  • de5de18: Version 2.0 widget is a simplified implementation that only displays "Resell with Authentified", or "Resold with Authentified".

    Why we've done this ​

    We have done this to simplify implementation for developers and ensure that any future listing statuses do not affect the operation of the widget.

    BREAKING CHANGES ​

    • All render props such as renderDraft, renderSold, etc have been removed, you can no longer customise the content of the button based on status. Buttons will now say Resell with Authentified or Resold with Authentified depending on the status of the item(s).
    • Updated React and React DOM peer dependencies from 18.2.0 to 19.0.0.
    • Design updates — The button is now opinionated about how it looks, and we have included our logo within the button. Some styles such as colours/padding/etc can be changed by using CSS variables.

Minor Changes ​

  • e007cf8: Design tweaks
  • 6925be0: Design tweaks
  • edfaaca: Design tweaks
  • 51d4969: Updated styles, added container, changed REM units to EMs
  • 933c82e: Design updates
  • bdb45a8: Updated styles, added container, changed REM units to EMs
  • f02e16f: Add customerId prop, remove hash from URL flow
  • 5ec03d6: Design updates

2.0.0-alpha.7 ​

Minor Changes ​

  • edfaaca: Design tweaks

2.0.0-alpha.6 ​

Minor Changes ​

  • 6925be0: Design tweaks

2.0.0-alpha.5 ​

Minor Changes ​

  • e007cf8: Design tweaks

2.0.0-alpha.4 ​

Minor Changes ​

  • 5ec03d6: Design updates

2.0.0-alpha.3 ​

Minor Changes ​

  • 933c82e: Remove comments

2.0.0-alpha.2 ​

Minor Changes ​

  • 51d4969: Updated styles, added container, changed REM units to EMs

2.0.0-alpha.1 ​

Minor Changes ​

  • f02e16f: Add customerId prop, remove hash from URL flow

2.0.0-alpha.0 ​

Major Changes ​

  • de5de18: Version 2.0 widget is a simplified implementation that only displays "Resell with Authentified", or "Resold with Authentified".

    Why we've done this ​

    We have done this to simplify implementation for developers and ensure that any future listing statuses do not affect the operation of the widget.

    BREAKING CHANGES ​

    • All render props such as renderDraft, renderSold, etc have been removed, you can no longer customise the content of the button based on status. Buttons will now say Resell with Authentified or Resold with Authentified depending on the status of the item(s).
    • Updated React and React DOM peer dependencies from 18.2.0 to 19.0.0.
    • Design updates — The button is now opinionated about how it looks, and we have included our logo within the button. Some styles such as colours/padding/etc can be changed by using CSS variables.

1.3.0 ​

Minor Changes ​

  • 1cc2603: Add renderPaused prop and paused status

1.2.1 ​

Minor Changes ​

  • 305ad17: Added awaiting-publish and awaiting-price-confirmation statuses
  • b677b8b: Added renderAwaitingPublish and awaitingPriceConfirmation

1.1.1 ​

Minor Changes ​

  • afd4c0a: Add renderExcluded render function

1.0.1 ​

Patch Changes ​

  • dd54281: Update dependencies
  • a1fb98a: Updated README and Docs

1.0.0 ​

Major Changes ​

  • d4e0c43: - Add support for offline orders
    • Remove deprecated render props:
      • renderAccepted
      • renderConsigned
      • renderWithdrawn
    • Improved error handling and performance

0.7.0 ​

Minor Changes ​

  • e49f176: Fixed incorrect base URL and union type

0.6.0 ​

Minor Changes ​

  • 00bc6f4: Update button props type

0.5.0 ​

Minor Changes ​

  • 08605d4: Add support for variantId instead of lineItemId

0.4.0 ​

Minor Changes ​

  • 013e338: Add new renderProps

    • renderListed
    • renderRejected
    • renderDelisted
    • renderAwaitingPostage
    • renderPosted

    Mark the following renderProps as deprecated

    • renderConsigned
    • renderAccepted
    • renderWithdrawn

0.3.0 ​

Minor Changes ​

  • 694956a: Remove customerId from props

0.2.0 ​

Minor Changes ​

  • 57282c6: Minor updates
    • Change base URL (internal change only)
    • Update README file
    • Add shopId parameter (required)

0.1.0 ​

Minor Changes ​

  • 27c0a12: Initial release

© Authentified 2026