> ## Documentation Index
> Fetch the complete documentation index at: https://developer.uphold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widgets changelog

> Track Uphold Widget releases — Payment Widget, Travel Rule Widget, and others — with new features, enhancements, and breaking changes (RSS available).

<Update label="2026.08.03" tags={["New Feature", "Payment"]}>
  ### Apple Pay support in Payment Widget

  **Summary**

  Introduced support for Apple Pay deposits and withdrawals in the [Payment Widget](/widgets/payment/introduction). Users authorize each transfer with the native Apple Pay sheet.

  The `authorize` flow also supports a new **headless mode** that renders only the Apple Pay button, letting you embed it directly into your own layout. See [`AuthorizeMode`](/widgets/payment/sdk-reference#authorizemode).

  This feature requires `@uphold/enterprise-payment-widget-web-sdk` version `0.15.0` or higher.

  **Documentation**

  * [APM overview](/developer-guides/apm-transfers/overview)
  * [Apple Pay deposit flow](/developer-guides/apm-transfers/deposit/via-payment-widget/apple-pay)
  * [Apple Pay withdrawal flow](/developer-guides/apm-transfers/withdrawal/via-payment-widget/apple-pay)
</Update>

<Update label="2026.07.16" tags={["New Feature", "KYC"]}>
  ### Profile process support for the KYC Widget

  **Summary**

  The [KYC Widget](/widgets/kyc/introduction) now supports the `profile` process, in addition to `identity` and `proof-of-address`. You can collect the user's basic information (name, date of birth, citizenship, and address) directly within the Widget by including `profile` in the session's `processes`.

  **Documentation**

  * [Installation and setup](/widgets/kyc/installation-and-setup)
  * [Onboard users via KYC Widget](/developer-guides/user-onboarding/individual/via-kyc-widget)
</Update>

<Update label="2026.07.13" tags={["New Feature", "Payment"]}>
  ### PayPal support in Payment Widget

  **Summary**

  Introduced support for PayPal deposits and withdrawals in the [Payment Widget](/widgets/payment/introduction).

  This feature requires `@uphold/enterprise-payment-widget-web-sdk` version `0.14.0` or higher.

  **Documentation**

  * [APM overview](/developer-guides/apm-transfers/overview)
  * [PayPal deposit flow](/developer-guides/apm-transfers/deposit/via-payment-widget/paypal)
  * [PayPal withdrawal flow](/developer-guides/apm-transfers/withdrawal/via-payment-widget/paypal)
</Update>

<Update label="2026.07.13" tags={["New Feature", "KYC", "Payment", "Travel Rule"]}>
  ### Responsive layout on larger screens and the `layout` option

  **Summary**

  Uphold Widgets now adapt to the available space. On phones they fill their container, and on larger screens (tablets and up) they render as a centered, fixed-size card. This applies to the [KYC Widget](/widgets/kyc/introduction), [Payment Widget](/widgets/payment/introduction), and [Travel Rule Widget](/widgets/travel-rule/introduction).

  To give applications control over this framing, all three Widgets now accept a new optional `layout` option:

  * `'boxed'` (default): on larger screens (tablets and up), centers the Widget and frames its content as a fixed-size card; on smaller screens it fills its container.
  * `'fluid'`: renders the Widget so it fills its container, with no frame or centering, so your own container (e.g. a modal) acts as the frame.

  This option is optional — the responsive layout is enabled by default (`'boxed'`), so no code changes are required to adopt it. Set `layout: 'fluid'` only when you want to provide your own framing.

  The `layout` option requires `@uphold/enterprise-kyc-widget-web-sdk` version `0.3.0`, `@uphold/enterprise-payment-widget-web-sdk` version `0.14.0`, or `@uphold/enterprise-travel-rule-widget-web-sdk` version `0.7.0` or higher.

  **Documentation**

  * [KYC Widget configuration options](/widgets/kyc/sdk-reference#options)
  * [Payment Widget configuration options](/widgets/payment/sdk-reference#options)
  * [Travel Rule Widget configuration options](/widgets/travel-rule/sdk-reference#options)
  * [WidgetLayout type](/widgets/payment/sdk-reference#widgetlayout)
</Update>

<Update label="2026.06.22" tags={["New Feature", "Payment", "Travel Rule"]}>
  ### New design system and richer theming for Payment and Travel Rule Widgets

  **Summary**

  The [Payment Widget](/widgets/payment/introduction) and [Travel Rule Widget](/widgets/travel-rule/introduction) now run on Uphold's new design system. This brings a refreshed visual appearance to both Widgets.

  On top of this, theme customization is now consistent across all Widgets through a shared `WidgetThemeOption` type. In addition to forcing `light` or `dark` mode, applications can now customize brand colors, typography, and per-component styles (button, input, and card border radii) on the Payment and Travel Rule Widgets, matching the customization already available on the KYC Widget. The Travel Rule Widget now also fully respects the selected appearance, including in dark mode.

  Rich theme customization on the Payment Widget requires `@uphold/enterprise-payment-widget-web-sdk` version `0.13.0` or higher.

  Rich theme customization on the Travel Rule Widget requires `@uphold/enterprise-travel-rule-widget-web-sdk` version `0.6.0` or higher.

  **Documentation**

  * [Payment Widget configuration options](/widgets/payment/sdk-reference#options)
  * [Travel Rule Widget configuration options](/widgets/travel-rule/sdk-reference#options)
  * [WidgetThemeOption type](/widgets/payment/sdk-reference#widgetthemeoption)
</Update>

<Update label="2026.06.15" tags={["New Feature", "KYC"]}>
  ### KYC Widget

  **Summary**

  Introduced the [KYC Widget](/widgets/kyc/introduction), a fully Uphold-managed, embeddable solution for collecting KYC data from your users without building a custom verification interface.

  <Note>The Widget currently supports the `identity` and `proof-of-address` processes. Support for additional processes will be added in future releases.</Note>

  **Documentation**

  * [KYC Widget introduction](/widgets/kyc/introduction)
  * [Installation and setup](/widgets/kyc/installation-and-setup)
  * [SDK reference](/widgets/kyc/sdk-reference)
  * [Onboard users via KYC Widget](/developer-guides/user-onboarding/individual/via-kyc-widget)
</Update>

<Update label="2026.05.11" tags={["Breaking Change", "Payment"]}>
  ### Asset selection in crypto withdrawal flow

  **Summary**

  The crypto withdrawal flow in the [Payment Widget](/widgets/payment/introduction) now supports crypto asset selection, along network and destination address, simplifying the user journey and concentrating all data collection required for a crypto withdrawal inside the Payment Widget.
  The `complete` event payload for `via: "crypto-network"` selections now includes a new `selection.asset` field containing the selected asset code (e.g. `BTC`, `XRP`).

  The updated `CryptoNetworkSelection` type ships in `@uphold/enterprise-payment-widget-web-sdk` version `0.12` or higher — partners should upgrade to that version to get proper TypeScript support for the new `selection.asset` field.

  **Documentation**

  * [Crypto withdrawal via the Payment Widget](/developer-guides/crypto-transfers/withdrawal/via-payment-widget)
  * [CryptoNetworkSelection type](/widgets/payment/sdk-reference#withdrawalselection)
</Update>

<Update label="2026.04.21" tags={["New Feature", "Payment"]}>
  ### Dark mode support in Payment Widget

  **Summary**

  Introduced dark mode support in the [Payment Widget](/widgets/payment/introduction). By default, the Widget automatically matches the user's system appearance preference. Applications embedding the Widget can also force a specific theme by passing the `theme` option when instantiating it.

  Theme override support requires `@uphold/enterprise-payment-widget-web-sdk` version `0.11` or higher.

  **Documentation**

  * [Payment Widget configuration options](/widgets/payment/sdk-reference#options)
</Update>

<Update label="2026.03.27" tags={["New Feature", "Payment"]}>
  ### ACH support in Payment Widget

  **Summary**

  Introduced support for ACH bank transfers in the [Payment Widget](/widgets/payment/introduction), allowing users in the United States to perform ACH deposits and withdrawals.

  **Documentation**

  * [ACH deposit](/developer-guides/bank-transfers/deposit/via-payment-widget/ach)
  * [ACH withdrawal](/developer-guides/bank-transfers/withdrawal/via-payment-widget/ach)
</Update>

<Update label="2026.02.11" tags={["New Feature", "Payment"]}>
  ### Account limit per asset in Payment Widget

  **Summary**

  Introduced the `maxAccountsPerAsset` option in the [Payment Widget](/widgets/payment/introduction), allowing partners to set the number of accounts that can be created per asset when generating bank deposit details. Check the documentation for more details on how this option works.

  **Documentation**

  * [maxAccountsPerAsset option](/widgets/payment/sdk-reference#options)
</Update>

<Update label="2026.01.30" tags={["New Feature", "Payment"]}>
  ### Crypto support and payment method filtering in Payment Widget

  **Summary**

  Introduced support for cryptocurrency deposits and withdrawals in the [Payment Widget](/widgets/payment/introduction). Users can now generate details for crypto deposits and provide destination addresses for crypto withdrawals.

  Partners can now configure which payment methods to make available to their users through the new `paymentMethods` option. This allows filtering by payment type (card, bank, crypto), and for crypto and bank options, filtering which assets are available to the user.

  **Documentation**

  * [Payment method filtering](/widgets/payment/sdk-reference#options)
  * [Crypto deposit](/developer-guides/crypto-transfers/deposit/via-payment-widget)
  * [Crypto withdrawal](/developer-guides/crypto-transfers/withdrawal/via-payment-widget)
</Update>

<Update label="2026.01.29" tags={["New Feature", "Payment", "Travel Rule"]}>
  ### Travel Rule Widget

  **Summary**

  Introduced the [Travel Rule Widget](/widgets/travel-rule/introduction), a fully Uphold-managed, embeddable solution that enables compliant collection and exchange of originator and beneficiary information for crypto transactions — ensuring adherence to global Travel Rule regulations.
</Update>

<Update label="2025.08.08" tags={["New Feature", "Payment"]}>
  ### FPS support in Payment Widget

  **Summary**

  Introduced support for Faster Payments Service (FPS) in the [Payment Widget](/widgets/payment/introduction), supporting instant push bank deposits and bank withdrawals for users in the United Kingdom and EU.

  **Documentation**

  * [FPS deposit](/developer-guides/bank-transfers/deposit/via-payment-widget/fps)
  * [FPS withdrawal](/developer-guides/bank-transfers/withdrawal/via-payment-widget/fps)
</Update>

<Update label="2025.05.06" tags={["New Feature", "Payment"]}>
  ### Card support in Payment Widget

  **Summary**

  Introduced the [Payment Widget](/widgets/payment/introduction), a fully Uphold-managed, embeddable solution that allows partners to support payment methods without implementing the API endpoints.

  The Payment Widget is launched with support for debit and credit cards.

  **Documentation**

  * [SDK reference](/widgets/payment/sdk-reference)
  * [Card deposit](/developer-guides/card-transfers/deposit/via-payment-widget)
  * [Card withdrawal](/developer-guides/card-transfers/withdrawal/via-payment-widget)
</Update>
