Skip to content

Job description authoring

Write and edit the job description with a rich-text editor that supports multi-language content. Format text, add lists and links, paste images.

Where to find it
Job detail → Description tab
Who can use it
Anyone with access to jobs. Editing requires edit access on jobs.

The Description tab on a job profile is where you write the job posting that candidates will read. It’s a rich-text editor with multi-language support — you write the description once per language, and candidates see the version that matches their preferred language.

The Description tab. Language picker at the top, rich editor in the middle, AI assistant accessible from the right.

Opening the editor

  1. Open the job

    Click any row in the jobs list.

  2. Click the Description tab

    Second tab from the left.

Picking the language

Switch language at the top to write the description in another language.

The job description has separate versions for each language. Pick a language at the top of the tab — English, French, or Spanish — to write or edit that version. Switching languages preserves what you wrote in the previous language; nothing is lost.

You don’t have to fill all three languages. When the job is published, candidates see whichever version matches their preferred language; if it’s missing, they see whatever version exists.

The rich-text editor

The toolbar has the basics — bold, italic, lists, links, headings, plus a See HTML toggle for power users.

The editor supports:

  • Text formatting — bold, italic, underline, strikethrough.
  • Lists — bullet lists and numbered lists, with nesting.
  • Headings — H2, H3 for sectioning the description.
  • Links — paste a URL or use the link button.
  • Images — paste from clipboard or use the image button.
  • See HTML code toggle — opens the raw HTML if you need to fine-tune the markup.

Short vs. full description

A job has two description fields:

  • Short description — a one-paragraph summary shown on the career page job card and in social media previews.
  • Full description — the complete job posting shown when a candidate opens the job page. Use the rich editor for this one.

Using AI to generate or improve the text

An AI assistant button is built into the toolbar. It lets you generate a description from a prompt or rewrite an existing description in a different tone. See AI-assisted description generation for the full flow.

Who can do what

What you want to do

What you need

Read the description

Access to jobs

Edit the description

Edit access on jobs

Tips

  • Write the short description last. It’s easier to summarise the long version than to expand a summary.
  • Use H2 for major sections. About the role / Responsibilities / Requirements / What we offer — that structure scans well on small screens.
  • Don’t paste a Word document raw. Word HTML drags in styles that fight the career page CSS. Either retype, or use See HTML code and clean it up.
  • Check both languages. If you write in English and ask the AI to translate, re-read the French version — names of clients, products, places sometimes get translated by mistake.