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 from Word.

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.
  • See HTML code toggle — opens the raw HTML if you need to fine-tune the markup.

It is the same editor used for email templates — see The rich-text editor for what every control does.

Pasting from Word

Most job descriptions arrive as a Word document, so pasting gets special handling: Nextal strips Word’s own markup automatically and keeps the text, the paragraphs, bold, italic, underline, colours, alignment, and links.

Three things do not survive the paste, and it is better to know before you go looking for them:

  • Images are removed. A notice tells you how many. The editor does not store images, and an image pasted from Word points at a file on your own computer anyway — invisible to candidates.
  • Tables are flattened. All the text is kept, but the grid is gone: each cell becomes its own paragraph.
  • Word’s lists stay as text. The bullets and numbers Word produces arrive as ordinary characters (·, o, §) at the start of each line. To get real lists, select the lines, click Bulleted list or Numbered list, then delete the leftover markers.

See Pasting from Word for the full detail.

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 doWhat you need
Read the descriptionAccess to jobs
Edit the descriptionEdit 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.
  • After pasting from Word, rebuild the lists. It is the only real clean-up left: Word’s bullets arrive as text. Two clicks per list, and the posting renders correctly everywhere.
  • 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.