html_notes and html_text launch update

Hey folks,

We’ve received some feedback about the new behavior. We’ll be making a change to how newlines are interpreted for the remainder of the rollout.

We originally announced v1 behavior on 2022-09-22. Today we’re modifying this with the announcement of v2 behavior.

Legacy Behavior

New HTML Tags in Asana Rich Text

v1 Behavior (announced 2022-09-22)

When an html_notes includes a double-newline (\n\n), the web UI gives this a special display treatment:

  • This is treated as a separator between “blocks”
  • Blocks group their associated text and provide a drag handle to allow reordering between blocks
  • Between one another, “blocks” have visual padding, but no editable empty line of text
  • API clients who wanted consecutive newlines (ex: to create an editable empty line between two lines of text) needed to include a zero-width space between newlines (\n\u200b\n) to distinguish it from a block separator (\n\n)

v2 Behavior Behavior

  • Any newline included by an API write is treated identically, with no special display behavior. Newlines put the following text on the next line of the editor.

Timeline

Completed

  • 22-09-22: we began rollout of v1 behavior to replace legacy behavior
  • 22-10-24: we completed rollout of v1 behavior, and legacy behavior was no longer available
  • 22-11-4: we began rollout of v2 behavior to replace v1 behavior

Upcoming

  • 22-11-22: we will complete rollout of v2 behavior to replace v1 behavior
3 Likes