Form Layout Information Missing in Marketing Forms API Response

Develop, Build & Integrate APIs & Integrations
1

I’m currently working with the HubSpot Marketing Forms API (v3) and have encountered an issue regarding form field layout information.

Issue: When I create a form ( using new editor and not legacy) in HubSpot with a 2x2 field layout (two fields per row), the visual editor displays this layout correctly. However, when I retrieve the same form via the API endpoint:

GET https://api.hubapi.com/marketing/v3/forms/{formId}

The API response does not include any layout information such as:

  • Row/column positioning
  • Field width/columnWidth properties
  • Row indices or grouping information

Current Behavior: All fields are returned in a flat array within fieldGroups, with no indication of how they should be positioned in rows or columns.

Expected Behavior: The API response should include layout metadata that indicates:

  • Which fields belong in the same row
  • Column width for each field (e.g., using a 12-column grid system)
  • Row positioning information

Example Form ID: c710cdb7-38e4-4fcb-b396-70df4ce4a5d0

Questions:

  1. Is there a different API endpoint that includes form layout information?
  2. Are there any field properties or metadata I’m missing in the current response?
  3. Is this feature planned for a future API version?

I’m building a custom form renderer and need to preserve the exact layout configured in HubSpot’s form builder. Any guidance on how to retrieve this information programmatically would be greatly appreciated.

Thank you for your assistance!

Best regards,
Mayank Bansal

2

Hey @MBansal6 - thanks so much for posting in the Community!
I’d like to tag in some Community experts here to see if they have any insight for us! @ashleyidesign, @RBozeman, and @felixmacaspac - any thoughts for @MBansal6?
Shane, Senior Community Moderator