Settings → Organization is the central place for an Org Admin to control the identity and behavior of their organization: name, URL slug, scoring scale, careers page content, and AI provider. Each section is independently editable — saving one does not affect the others.
Prerequisites
Organization name and slug
The Organization card on the settings page lets you update two fields independently.
- Open Settings → Organization.
- Edit the Name field and select Save to update the display name.
- Edit the Slug field and select Save to update the URL.
After saving a new slug, your careers page URL and all internal navigation links update immediately. Share the new URL before decommissioning any external links that reference the old one.
Scoring scale
The Interview Scoring Scale card under Settings → Organization controls how interviewers rate answers during a session. Changes apply to new interviews only — existing interviews keep the scale they were created with.
Picking a preset
Three built-in presets cover most teams:
| Preset | Levels | Range |
|---|---|---|
| Simple | 3 | No · Maybe · Yes |
| Standard | 5 | Strong No → Strong Yes |
| Detailed | 10 | 1 → 10 |
Click any preset card to select it. A live preview of the rating bar appears beneath the selector so you can see exactly what interviewers will see before saving.
The default scale when a new organization is created is Standard (5 levels).
Fully custom labels
If the presets do not match your process, select Customize labels & colors below the preset picker to open the editor. From there you can:
- Rename any level — each label supports up to 30 characters.
- Change the color — pick from the palette or enter a hex code directly.
- Change the icon — select a different icon from the icon picker for each level.
- Add a level — select Add level to append a new level (maximum 10).
- Remove a level — hover a row and select the remove button (minimum 2 levels required).
When you are satisfied, select Save Changes. Selecting Cancel discards all unsaved edits.
Snapshot isolation — existing interviews are unaffected
When you save a new scale, Intervy records only the date of the change. Each in-progress and completed interview retains the scale that was active when it started. Interviewers who return to an older interview continue to see the original rating options, not the updated ones.
This means you can safely adopt a new scale for upcoming positions without disturbing any ratings already collected.
When to switch scales
- Switch before launching a new set of job positions — all phases in those positions will use the new scale from the first interview.
- Avoid switching mid-pipeline for an active position. Interviewers in earlier completed phases will have used the old scale; later phases will use the new one, making direct score comparisons harder.
- A Simple (3-level) scale works well when your interviewers are new to structured interviewing and you want a low-friction entry point.
- A Detailed (10-level) scale is useful when you want fine-grained differentiation across a large candidate pool.
Careers page content
The careers settings appear under Settings → Organization and control what candidates see on your public careers page.
Publishing
Use the Publish card to control whether your organization's careers page is publicly accessible.
- When the toggle shows Live, your page is accessible at
careers.intervy.ai/<your-org-slug>. - When the toggle shows Hidden, the URL returns a not-found page regardless of open positions.
- Individual job positions have their own visibility setting. Closed and hidden positions are never exposed even when publishing is on.
Select Preview careers page (available when publishing is on) to open the live careers page in a new tab.
Page content
The Page content card controls the copy displayed in the header of your careers index:
- Org tagline — a short subhead displayed under the org name (up to 120 characters).
- About section — the "Who we are" block below the position list. Markdown is supported. Switch between Write and Preview tabs to check formatting. The section supports up to 10,000 characters.
Both fields save immediately when you select Save or move focus away from the field.
Privacy & brand
The Privacy & brand card has two fields:
- Privacy policy URL — an
https://link shown in the candidate disclosure footnote on each application form. Leave it empty to omit the footnote. Requires a Growth plan or higher. - Org logo — replaces the default monogram in the careers page header. Logo upload is available on the Scale plan.
AI provider
The Ivy card under Settings → General controls how the Ivy AI co-pilot is powered. This setting is per-user, not per-organization.
- Toggle Enable Ivy on or off to activate or deactivate Ivy entirely.
- When Ivy is enabled, choose a mode:
- Intervy Credits — Ivy uses your organization's credit balance. The remaining credit count is shown in the card.
- Your own API key — Ivy uses an API key you supply. Select a provider (Anthropic API Key or OpenAI API Key) and a model, then paste your key. The key is stored securely and never returned in plain text.
- To verify a key before saving, the card tests it against the provider's API and shows whether it is valid.
Deleting the organization
The Danger Zone card is shown only to users with org:delete. Selecting Delete organization opens a confirmation dialog. Select Delete to confirm. Deletion is permanent and cannot be undone.
Permissions reference
| Action | Permission | Default roles |
|---|---|---|
| View organization settings | org:view | AdminStaffing |
| Update organization name, slug, and settings | org:manage | Admin |
| Delete organization | org:delete | Admin |
| View careers page settings | careers:view | AdminStaffing |
Troubleshooting
"Failed to update organization name" — Another save is already in progress or the request failed. Wait a moment and try again.
"Slug must be 2-48 characters, lowercase letters, numbers, and single hyphens only (no leading/trailing or doubled hyphens)" — The slug you entered did not pass validation. Correct the slug and select Save again.
"Use a full URL starting with https://" — The privacy policy URL you entered is not a valid web address. Enter a full URL beginning with https:// (or http:// for non-secure legacy links).
Tagline or about section not saving — The tagline is limited to 120 characters and the about section to 10,000 characters. If either field exceeds the limit, the Save button is disabled. Shorten the text to re-enable saving.