Yousaf — GoHighLevel customization engineerYousaf.
Scale & Governance

Multi-Tenant Theme Management for SaaS Agencies — Groups, Plans & Bulk Theming

A deterministic precedence chain — group → location → SaaS plan → global → stock — that governs hundreds of sub-accounts from one Theme Studio with bulk operations.

500+
Locations in one studio
<5 min
Agency-wide restyle
1
Master kill-switch
The challenge

What made this hard

Theming one location is easy; governing hundreds is not. The agency needed answers to hard questions: what happens when a location has its own theme and belongs to a themed group? What should new sub-accounts look like by default? How do you restyle 60 locations without 60 edit sessions?

The solution

How I built it

I designed a strict, CDN-mirrored precedence chain — group → location's own theme → SaaS plan → global default → stock GHL — so every location's look is always deterministic:

Location Groups

Bundle locations and theme them as one unit. Joining a group deliberately takes ownership (the member's individual config is removed), so there's never a hidden theme waiting to resurface.

SaaS Plan Theming

Locations are auto-grouped by the GHL SaaS plan they're subscribed to — every “Pro” customer gets the Pro look with zero manual assignment.

Global Theme

The agency-wide fallback for anything unthemed, with a live count of how many locations currently inherit it.

Bulk Bar + Theme Studio

Multi-select locations to apply, duplicate or reset in one round-trip (MongoDB bulkWrite, unordered so one bad ID never aborts the batch) — all from a command center that renders every location as a live miniature of its actual effective theme.

Under the hood

Technical highlights

The studio loads 500+ locations in background batches so first paint is instant; filtering, search and sorting never hit the network. Every card preview resolves the location's true effective theme client-side using the same precedence logic the CDN uses — what you see in the studio is exactly what the client sees.

The outcome

Results

  • Agency-wide restyle: from 3 days of manual work to under 5 minutes
  • New client onboarding inherits correct branding automatically
  • One master switch pauses all theming instantly for troubleshooting
What the client said

A note from the client

"We were dreading re-theming sixty locations by hand. With the studio it took one afternoon — select, apply, done. The group and SaaS-plan logic means new clients just inherit the right branding automatically now, so onboarding got noticeably faster. The master switch has already saved us twice during troubleshooting. This was the piece I didn't even know we were missing." — Priya Nair, Operations Lead, Scale Collective. Rated 5 out of 5. Reviewed February 2025.

Want something like this for your agency?

Tell me what you want your GoHighLevel platform to do, and I'll scope it within one business day.

Yousaf, GoHighLevel white-label customization engineer