Skip to content
HubSpot Developer Changelog

Upcoming Sunset: JSON Custom Cards

Previously, HubSpot released a beta allowing users to utilize private apps and projects to build a custom card with JSON-based components for UI extensibility within the CRM development tools. 

However, a new custom card UI extension with React components will replace the JSON custom cards within the CRM development tools. This change results from the feedback and use cases end users shared from the CRM development tools public beta that helped define this new chapter for custom cards and UI extensibility at HubSpot.

What’s happening?

Starting September 2023, no new HubSpot accounts can create custom card extensions with JSON. Any existing custom cards with JSON-based components will stop working by March 31st and will stop rendering; however, we will not delete the project source code from the associated HubSpot account. In addition, any new beta enrollment for CRM development tools will be React only by default, and any new JSON cards uploaded will be blocked. Lastly, all supporting documentation and code samples for JSON have been replaced with React-based custom cards.

It’s highly recommended that you rebuild the JSON custom cards with React. Please refer to this guide to help you rebuild your custom cards. You can also reference these examples of React extensions and the CRM customization landing page to familiarize yourself with the new toolset better.

Note: Any public apps built via an app developer account, which includes Marketplace Apps, will not be affected.

What does this mean for developers?

The recent React custom card UI extension change will offer more flexibility and interactivity through an enhanced front end. This will allow developers to achieve better development results while also enabling more complex customizations. Previously, the system relied solely on backend and serverless-driven approaches. However, with the introduction of UI extensions, developers can now create front-end experiences using React while still being able to use HubSpot’s serverless functions when necessary. This approach provides developers access to the active ecosystem and open-source tooling that React is known for.

When is this happening?

The sunset for this feature is scheduled for March 31, 2024. If you have any inquiries or concerns, please contact us via the Developer Slack channel, #crm-customization-beta. Alternatively, you can visit our community post to share your feedback or ask questions.