Settings overview
Map of every /dashboard/settings/* page, who can access it, and how feature flags hide or reveal tabs.
The Settings hub lives at /dashboard/settings. Visiting the root redirects to Account (/dashboard/settings/account). A horizontal tab bar in the settings layout lists every section; tabs you cannot access are omitted rather than shown disabled.
Access model
| Requirement | Who sees it |
|---|---|
| Any signed-in user | Account, Notifications |
Organization Admin (canManageOrganization) | All other settings tabs |
| Per-tenant feature grant | Feature-gated tabs (see below) |
The API enforces permissions on every mutation. The UI hides unavailable tabs, but server checks remain authoritative.
Complete settings map
Personal (any member)
| Tab | Path | Purpose |
|---|---|---|
| Account | /dashboard/settings/account | Profile, password/passkeys, language, timezone |
| Notifications | /dashboard/settings/notifications | Per-event email frequency (immediate, daily digest, weekly digest, disabled) |
Organization (admin only)
| Tab | Path | Purpose |
|---|---|---|
| Organization | /dashboard/settings/organization | Org name, industry, size, website; rejection reasons; rating categories |
| Careers | /dashboard/settings/careers | Public careers page URL, custom domain, job listing visibility |
| Branding | /dashboard/settings/branding | Logo, colors, candidate experience copy, email footer |
| Culture | /dashboard/settings/culture | Culture profiles and per-position overrides (requires culture_fit_scoring grant + org opt-in) |
| Team | /dashboard/settings/team | Invite, resend, edit roles, remove members |
| Billing | /dashboard/settings/billing | Plan, Stripe subscription, usage, invoices, payment methods |
| Integrations | /dashboard/settings/integrations | ATS, job boards, calendar OAuth, background checks, webhooks |
| Data Export | /dashboard/settings/data-export | Bulk CSV/JSON exports for compliance and migration |
Feature-gated (admin + platform grant)
These tabs appear only when the org has the matching grant and the platform kill switch is ON. The settings layout probes trpc.*.capabilities and hides the tab silently when enabled !== true.
| Tab | Path | Flag slug |
|---|---|---|
| Custom Fields | /dashboard/settings/custom-fields | custom_fields |
| Approvals | /dashboard/settings/approvals | job_governance |
| Intake Forms | /dashboard/settings/intake-forms | job_governance |
| Pipelines | /dashboard/settings/pipelines | custom_pipelines |
| Interview Kits | /dashboard/settings/interview-kits | structured_interviews |
| Compliance | /dashboard/settings/compliance | dei_compliance or candidate_surveys |
See Platform feature flags for how grants are enabled.
Related routes outside the settings tab bar
Some admin workflows live on adjacent paths but are linked from the main navigation Settings dropdown:
| Surface | Path | Notes |
|---|---|---|
| Team invitations | /dashboard/team/invitations | Pending invite management |
| Email settings | /admin/email-settings | Org-level Mailgun/sender configuration |
| Email templates | /admin/email-templates | Journey, invite, and transactional templates |
| Document templates | /admin/document-templates | Offer letters and similar |
| Approvals inbox | /dashboard/approvals | Pending job/requisition approvals (job_governance) |
| Requisitions | /dashboard/requisitions | Headcount requests (job_governance) |
| Tasks inbox | /dashboard/tasks | Recruiter tasks from pipeline automations (custom_pipelines) |
Integration sub-routes
| Path | Integration |
|---|---|
/dashboard/settings/integrations/linkedin/setup | LinkedIn OAuth + Apply Connect |
/dashboard/settings/integrations/linkedin/complete | OAuth callback landing |
/dashboard/settings/integrations/accurate/setup | Accurate Background credentials |
/dashboard/settings/integrations/indeed | Indeed employer setup (when enabled) |
Settings layout behavior
The tab list is defined in insighthire-web/app/dashboard/settings/layout.tsx. Feature gates map to tRPC capability probes:
customFields → trpc.customFields.capabilities
jobGovernance → trpc.governance.capabilities
customPipelines → trpc.pipelines.capabilities
structuredInterviews → trpc.interviewKits.capabilities
deiCompliance → trpc.compliance.capabilities (deiEnabled OR surveysEnabled)Compliance tab visibility is the union of DEI and candidate survey grants — either flag is enough for the tab to appear.
Recommended setup order
For a new tenant, admins typically configure in this sequence:
- Organization — legal name, industry, rejection reasons
- Branding + Careers — logo, colors, public jobs URL
- Team — invite recruiters and hiring managers
- Integrations — calendar, LinkedIn, ATS as needed
- Billing — upgrade from trial before hitting usage caps
- Feature-gated modules — custom fields, governance, pipelines, interview kits (once granted)