Interview portal configuration

Generates the document imported by Portal customisation → Interview portal → Import configuration. The interview portal is the candidate-facing side: the public position pages, the apply flow, and the screens a candidate sees around an interview. It is a different product from the coaching portal and has its own languages and content. Every field is optional — omitted fields keep their current value. Languages are only ever added, never removed.

Document

{
  "kind": "interview-portal",
  "version": 1,

  "languages": ["en"],

  "pages": [
    {
      "language": "en",

      "hero_box": "# Join the team at _Northgate_\n\nEvery application is reviewed by a person.",
      "about_box": "## About us\n\nWe run 14 clinics across the region.",
      "quote": "The interview felt like a conversation, not an interrogation.",

      "readmore_text": "Read about our hiring process",
      "readmore_link": "https://northgate.example.org/careers/process",
      "readmore_button": "How we hire",

      "interview_completed_box": "Thanks — we will be in touch within five working days.",
      "application_tracking_box": "Track your application any time using the link in your email.",

      "support_page": "## Help\n\nEmail careers@example.org.",

      "public_avatar_id": null,
      "discover_id": null,

      "public_interviews_disabled": false,
      "disable_easy_apply": false
    }
  ]
}

Fields

Field	Type	Where it appears
`languages`	string[]	Language codes to enable on the interview portal.
`pages[].language`	string	Required on every page entry.
`hero_box`	markdown	Top of the public position page.
`about_box`	markdown	”About the company” section.
`quote`	string	Pull quote. Plain text, no markdown.
`readmore_text`	string	Label of the read-more block.
`readmore_link`	url	Its target.
`readmore_button`	string	Its button text.
`interview_completed_box`	markdown	Shown after a candidate finishes an interview.
`application_tracking_box`	markdown	Shown on the application-tracking screen.
`support_page`	markdown	The portal’s support page.
`public_avatar_id`	uuid \| null	Avatar on public pages. Leave `null` unless you have a real id.
`discover_id`	uuid \| null	Discovery interview. Leave `null` unless you have a real id.
`public_interviews_disabled`	boolean	`true` hides publicly listed interviews.
`disable_easy_apply`	boolean	`true` removes the one-click apply route.

The read-more block

readmore_text, readmore_link and readmore_button are one unit. Supply all three or none — a partial set renders a block with a missing label or a button that goes nowhere.

Ids

public_avatar_id and discover_id are database ids. Never invent them. If you do not have a confirmed id, emit null or omit the field. A fabricated id produces a broken page rather than a validation error, because the importer cannot check ids that live in another table.

Markdown

Rendered with a restricted renderer: headings, bold, italic, lists, links. In hero_box, wrapping a word in _underscores_ renders it as the italic accent word. Keep interview_completed_box short — it is read once, by someone who has just finished an interview and wants to know what happens next. Say what happens and when.

Rules

Put the primary language first in pages[] — the editor opens on it after import.
Write candidate-facing copy in second person (“your application”), not third (“the candidate’s application”).
Do not set public_interviews_disabled: true on a portal whose whole purpose is a public careers page; check before emitting it.

​Interview portal configuration

​Document

​Fields

​The read-more block

​Ids

​Markdown

​Rules