## Why It Matters

Your career portal is the public face of your hiring. It's where candidates browse open roles, learn about your company, and submit applications. A well-configured portal makes a strong first impression and drives more qualified applicants into your pipeline.

## How the Career Portal Works

Every Kit account gets a career portal at a URL based on your account subdomain:

```
https://startupkit.app/careers/your-subdomain
```

The portal lists all your published job postings. Candidates can search by title, filter by location or department, and click into any job to see the full description and apply.

## Branding Your Portal

Navigate to [Hiring > Settings > Career Portal](/hiring/settings/career_portal) to customize how your portal looks. Kit supports several branding options:

### Logo

Upload your company logo in SVG, PNG, or JPEG format. You can upload two variants:

- **Logo** — Used on light backgrounds
- **Logo (Dark)** — Used on dark backgrounds (optional — falls back to the main logo if not set)

### Logo Display Mode

Control how your logo appears in the portal header:

| Mode | What Shows |
|------|------------|
| Branded | Logo + your company name |
| Logo Only | Logo without text |
| Brandless | No logo or company name — minimal header |

### Primary Color

Set a hex color (e.g. `#111827`) for buttons, links, and accent elements. Kit automatically calculates accessible contrast colors for text on buttons. Use a dark, saturated color for best results.

### Font

Choose a custom Google Font family for your portal's body text. Leave blank to use the default system font (Inter). The font selector shows a preview of each option.

### Light/Dark Mode

Choose between a light or dark theme for your portal. This sets the background, text colors, and card styling. The career portal settings page includes a live preview of both modes so you can compare before saving.

## Custom Domains

By default, your career portal is accessible at your app's domain with your subdomain slug. If your account has a custom domain configured (e.g. `careers.yourcompany.com`), the career portal resolves there automatically — no path prefix needed.

Custom domains make your career page feel like a native part of your website. See [Custom Domains](/docs/custom-domains) for setup instructions.

## Your Portal URL

Your career portal URL is always available at the top of any published job posting. You can also construct it manually:

```
https://yourapp.com/careers/{your-subdomain}
```

Share this URL on your website, social media profiles, and job boards to drive candidates directly to your portal.

## Quick Checklist

- [ ] Upload your company logo (and dark variant if using dark mode)
- [ ] Set a primary color that matches your brand
- [ ] Choose a logo display mode (branded, logo only, or brandless)
- [ ] Select light or dark theme
- [ ] Optionally choose a custom Google Font
- [ ] Verify the portal looks right by visiting your career portal URL
- [ ] Link your career portal from your company website