Guides
Retool Subfolders for Apps: How to Organize at Scale
If you've been managing a growing Retool workspace, you've probably felt the pain: a single flat list of apps, prefixed names like finance_v2_FINAL, and folders that balloon to dozens of entries with no clear hierarchy. The good news is that Retool subfolders for apps are now available for all cloud organizations, and they change the way teams can organize their internal tools. Here's everything you need to know to use them effectively.
Why Retool App Organization Becomes a Problem Fast
Early on, a Retool workspace feels manageable. You have five apps, maybe ten, and a couple of folders keeps things tidy. But as your team scales — breaking monolithic apps into smaller, focused tools, onboarding new teams, or building separate back-office and ops-facing products — the flat folder structure hits a wall fast.
The community thread that sparked this feature update is a perfect example. Teams were resorting to hacks like adding prefixes to app names (ops_, finance_, hr_) just to simulate grouping. One user described folders growing so large they became impossible to navigate. Another noted it was "hard to scale without this feature." These aren't edge cases — they're the default experience for any org running more than 20–30 apps in Retool.
What Retool Subfolders Actually Give You
Subfolder creation allows you to nest folders inside existing folders within your Retool dashboard. Instead of a flat list like:
Back Office(30 apps)Finance(15 apps)Operations(20 apps)
You can now build a real hierarchy:
Back OfficeHR ToolsFinance FormsAudit Dashboards
OperationsLogisticsCustomer Support
This is especially useful when you need to separate concerns — for example, keeping customer-facing support tools away from internal finance apps, or isolating experimental builds from production-ready tools.
How to Create Subfolders in Your Retool Cloud Org
Subfolder creation is available to all cloud organizations. Here's how to set it up:
- Step 1: Navigate to your Retool home dashboard and open an existing folder, or create a new top-level folder for the parent category.
- Step 2: Inside the folder, look for the
+ Newbutton or the folder creation option in the left sidebar or context menu. Select Create subfolder. - Step 3: Name your subfolder using a clear, consistent naming convention (more on this below). Avoid vague names like
MiscorOther. - Step 4: Drag and drop existing apps into the new subfolder, or create new apps directly inside it.
- Step 5: Repeat for each logical grouping. Aim for a maximum of two to three levels of nesting — deeper than that and navigation becomes its own problem.
Best Practices for Structuring Retool Subfolders
Having the feature is one thing; using it well is another. Here are practical rules that work for teams managing complex Retool workspaces:
- Organize by team or domain first, then by function. Top-level folders should map to business units (
Finance,Operations,Engineering). Subfolders then hold the specific tools or workflows within that domain. - Use a consistent naming convention. Pick a format and stick to it. Title Case works well:
Customer Support / Ticket Management, notcustomer support / ticket_mgmt_v2. - Keep app names short once they're inside a subfolder. If the app lives in
Finance / Payroll, the app name doesn't need to sayFinance Payroll Dashboard— justDashboardis enough. - Don't over-nest. Two levels deep (folder → subfolder) is almost always sufficient. Three levels is occasionally justified. Anything deeper is a sign you need fewer, broader categories — not more folders.
- Review and prune quarterly. Defunct apps and stale tools accumulate. A well-structured hierarchy only stays useful if outdated entries are archived or deleted regularly.
Who Should Use Retool Subfolders Right Now
If your org has fewer than 15–20 apps, you probably don't need subfolders yet — a flat folder structure with good naming is still manageable. But if any of the following apply, it's time to restructure:
- You're using name prefixes like
ops_orfin_to simulate grouping - Any single folder contains more than 10–12 apps
- New team members struggle to find the right tool without asking someone
- You're breaking large Retool apps into smaller modular tools and losing track of what belongs together
Subfolder creation is available for all Retool cloud organizations now. If you're on a self-hosted instance, check your version's release notes or the Retool changelog, as feature availability may differ.
The Bottom Line
Retool subfolders for apps solve a real, recurring problem that every growing team eventually hits. The fix is straightforward once the feature is available — but the bigger win is taking the time to design a folder hierarchy that reflects how your team actually works, not just how things evolved. Set it up properly now and you'll save yourself a messy reorganization six months down the line.
Ready to build?
We scope, design, and ship your Retool app — fast.