# New forms layout and API

**URL:** <https://community.hubspot.com/t/new-forms-layout-and-api/152909>\
**Category:** Develop, Build & Integrate\
**Tags:** professional\
**Created:** [July 13, 2026, 10:40pm UTC](https://community.hubspot.com/t/new-forms-layout-and-api/152909 "2026-07-13T22:40:41Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![BenChapman](https://avatars.discourse-cdn.com/v4/letter/b/91b2a8/32.png) [@BenChapman](https://community.hubspot.com/u/BenChapman)\
**Post date:** [July 13, 2026, 10:40pm UTC](https://community.hubspot.com/t/new-forms-layout-and-api/152909/1 "2026-07-13T22:40:41Z")

</div>

We use the forms api marketing/v3/forms/ to retrieve form definitions and then build the form on our website.

For the legacy forms, fieldGroups comes through as an array of arrays, so we could match the layout set in the editor.

For new forms, fieldGroups is simply an array. Fields that were set to be side-by-side in the editor, no longer come through grouped together in an array.

Is there any way to retrieve the layout of new forms? Or to group fields that are intended to sit side-by-side?

---

<div class="post-metadata">

**Author:** ![STierney](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stierney/32/186066_2.png) [@STierney](https://community.hubspot.com/u/STierney)\
**Post date:** [July 13, 2026, 11:24pm UTC](https://community.hubspot.com/t/new-forms-layout-and-api/152909/3 "2026-07-13T23:24:31Z")

</div>

Hey @BenChapman,

Thanks for posting in the Community!

I’d like to tag in a few Community experts to see if it’s possible to retreive the layout of the new forms, or, to group fields that are intended to sit side-by-side! @zach_threadint, @stefen, and @SteveHTM - are any of you aware of how @BenChapman might be able to achieve this?

Shane, Senior Community Moderator

---

<div class="post-metadata">

**Author:** ![Anton](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/anton/32/103167_2.png) [@Anton](https://community.hubspot.com/u/Anton)\
**Post date:** [July 14, 2026, 7:47am UTC](https://community.hubspot.com/t/new-forms-layout-and-api/152909/4 "2026-07-14T07:47:36Z")

</div>

Hey @BenChapman,

as far as I know, the new forms API doesn’t support the layout, only the fields/inputs.

I’d say you got two options:

1. Use the embed code to embed the form directly on your external page
2. Use legacy forms (which are way better for customization) / old API

Maybe somebody else got a different idea/experience, but this is one more reason for me to not recommend/use the new forms

best,  
Anton

---

<div class="post-metadata">

**Author:** ![system](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/system/32/124_2.png) [@system](https://community.hubspot.com/u/system)\
**Post date:** [July 21, 2026, 12:24am UTC](https://community.hubspot.com/t/new-forms-layout-and-api/152909/5 "2026-07-21T00:24:55Z")

</div>

Automatically bumped on July 21, 2026, 12:24am UTC