Format posts

How to get there: Click All posts (via a board’s breadcrumb or the sidebar shortcut, when available), open a post, then click Edit on its description. You can also format text while creating a post or writing a comment.

Use the rich text editor to format your content directly. Select text and choose a toolbar option; you see the formatting while you write. You do not need to type Markdown syntax.

Text formatting

The toolbar includes these options. In a compact editor, click ... (More formatting options) to see the additional controls.

Option Example use
Bold, italic, underline, strikethrough Make Steps to reproduce stand out, or strike through an outdated requirement.
Headings Divide a longer post into Summary, Steps to reproduce, and Expected result.
Numbered and bulleted lists Number reproduction steps or list requested improvements.
Links Select “View the checkout page”, click the link button, and enter the page URL.
Blockquote Quote a customer's feedback separately from your response.
Code block Include an error message such as Payment failed: request timed out.
Alignment, text color, and background color Align content or highlight a short passage.
Clear formatting Remove formatting from selected text.
Table Compare expected and actual behavior in columns.

For example, a bug report can have a Steps to reproduce heading followed by a numbered list:

  1. Open the checkout page.
  2. Select Pay by card.
  3. Click Pay. The page stays on the loading screen.

Then add Expected result: The order confirmation appears.

Add images

Click the image button in the toolbar and choose a file. You can also paste an image from your clipboard into the editor. The image uploads and appears in your text.

For example, paste a screenshot of the stuck checkout screen immediately below your reproduction steps.

Click an inserted image to choose S, M, L, or Full width. These correspond to 300, 500, 800 pixels, or the full available width. Use the remove-size button to clear the chosen size.

Add videos

Use the video button to insert a video. You can also paste a YouTube or Vimeo URL into the editor to embed it, for example a recording that demonstrates the problem.

Mention a person with @

  1. Type @ followed by the person's name, for example @Ruben.
  2. Select the matching person from the dropdown.
  3. Continue your sentence: “@Ruben could you check the checkout error?”

Selecting the person creates a clickable mention. Simply typing their name without selecting a suggestion does not create the mention.

A person mentioned in a comment can receive an email notification, depending on their notification preferences. Mentions in post descriptions do not send a separate mention notification.

Reference another post with

  1. Type # followed by part of a post title, for example #Improve checkout.
  2. Select the matching post from the dropdown.
  3. Continue your sentence: “This bug also affects #Improve checkout.”

The selected post appears as a linked reference to that post. Choose a post that exists in your portal; the example title above illustrates what to search for. Referencing a post does not send a mention notification.

You can combine both in a comment: “@Ruben can you check whether this is covered by #Improve checkout?” Select each suggestion as you type.