How to Organize Custom Field Folders in GoHighLevel

A sub-account with 120 custom fields in one long list is hard for reps to use and hard for builders to maintain. The fix is a folder system that matches how people actually work, and a habit of keeping it tidy. Here's how to organize custom field folders in GoHighLevel with native settings, plus the shortcuts we use when a sub-account has grown messy.

Why folders matter more than they seem

Folders aren't just for the settings page. They decide how fields are grouped on the contact record, so a rep looking for "Monthly Revenue" during a call either finds it in a second or scrolls past 40 fields to get there. Clean folders also make snapshot templates easier to reuse and make onboarding new builders faster.

Moving a field between folders doesn't change its key, its merge tag or the data stored in it. It's safe to reorganize at any time.

A folder system that works

Group by when the information is used, not by field type. For a funding broker, a typical layout looks like this:

A home-services client might use Job Details, Property, Estimate and Follow-up. The principle is the same: a rep should be able to guess the folder.

Inside each folder, alphabetical order is the easiest to scan. People don't remember the order fields were created in.

How to organize custom field folders in GoHighLevel

Create the folders

As of October 2026:

1. Go to Settings, then Custom Fields.
2. Choose the object (Contact or Opportunity) at the top.
3. Open the Folders tab.
4. Click Create Folder, name it and save.

Repeat for each folder. Opportunity fields have their own folders, separate from contact folders.

Move existing fields into folders

For a single field:

1. On the Fields tab, find the field and open it for editing.
2. Change its folder and save.

For several at once, HighLevel's field list lets you select multiple fields with checkboxes, and in many accounts the bulk action available is moving them to a folder. Reports on this vary by account and object (bulk delete, notably, is still a long-standing request on HighLevel's ideas board), so test it in your account before planning around it.

Put fields in a sensible order

Field order inside a folder can be adjusted by hand. If you want strict A–Z order across a big folder, it's tedious: every new field lands out of place and you fix it again.

Using the API

If you're scripting the cleanup, each field can be updated through PUT /locations/{locationId}/customFields/{fieldId} with a parentId set to the target folder's ID. The field list endpoint returns each field's current parentId and position, so you can work out what to move. You'll need a token with the custom fields write scope.

Naming rules that keep folders tidy

Folders stay organized longer when field names follow a few rules:

• Lead with the noun. "Bank Statement 1, 2, 3" sorts together. "First Bank Statement" and "Second Bank Statement" don't.
• Skip the folder name in the field name. "Application - Industry" is redundant inside an Application folder and makes keys longer.
• Use the same names in every sub-account. Identical names produce identical keys when fields are created, which makes copying workflows between clients much safer.
• Avoid "new," "old" and "2." They're signs a field needs replacing, not a name.

Cleanup tips for inherited sub-accounts

• Start with duplicates. Before you move anything, find near-duplicates like "Monthly Revenue" and "Monthly Revenue 2." Our field key guide shows how to confirm which one your forms use.
• Don't rename keys you depend on. Renaming the label is fine. Workflows and webhooks rely on the key, which a rename won't reliably update.
• Make an "Archive" folder. Fields you aren't sure about can go there instead of being deleted. Deleting a field removes its data.
• Fix the template, not just the client. If the mess came from a snapshot, organize the template sub-account too, or the next client inherits the same problem.

Where the native way gets slow

Moving 60 fields one by one is a long session of open, change folder, save. Bulk move helps when it's available, but you still have to find and tick each field in a long list. And there's no native one-click alphabetize, so folders drift out of order every time someone adds a field.

How Sub-Account Manager handles it

Sub-Account Manager has two features for exactly this cleanup:

• The field mover moves fields between folders in bulk. Show the fields in one folder, select the ones you want (or paste a list of names and it ticks the matches, with close-match suggestions you can untick), pick the destination and move. Only the folder changes. The data in each field stays as it is.
• The folder alphabetizer puts every field in a folder in A–Z order in one click. You see the new order before anything changes. It works for contact and opportunity fields.

One honest quirk: HighLevel's API doesn't share folder names for contact and opportunity fields, so Sub-Account Manager names each folder after the fields inside it. Empty folders can't be detected that way, so for a brand-new empty folder you paste its ID instead.

If you're building a new sub-account from scratch, the bulk field creator can file fields into the right folder as they're created, so there's nothing to move later.