View Categories

Task Description Caused Errors

If your feed fails when creating a task, the problem may be the task description. Asana only supports certain kinds of rich text and may reject unsupported content.

Supported HTML #

The following HTML tags are supported in task descriptions:

  • <body>, <h1>, <h2>
  • <strong>, <em>, <u>, <s>
  • <code>
  • <ol>, <ul>, <li>
  • <a>, <blockquote>, <pre>
  • <hr>, <img>

Anything else will be stripped out or converted, which can lead to unexpected results.

Automatic Recovery #

The plugin now reduces these failures in two ways:

  • Malformed markup is auto-balanced. Before sending, the description is corrected so unclosed or orphaned tags (common when a description contains code or pasted AI output with literal < > characters) cannot break the request.
  • Plain-text retry. If Asana still rejects the rich-text description, the plugin automatically retries once with the description as plain text, so the task is created instead of failing.

Description Format (per feed) #

Each feed has a Description Format setting:

  • Rich text (HTML) (default) — supported tags are rendered, and the markup is auto-corrected if needed.
  • Plain text — angle brackets are shown as literal text instead of being interpreted. Choose this when the description contains code or AI-generated content (for example a code review) so tags such as <strong> appear as text rather than being treated as formatting.

Common Pitfalls #

  • Using the {all_fields} merge tag: This generates a full table, which isn’t supported. Avoid using it in the description.
  • Adding unsupported fields: Some fields (like the Signature field) can produce markup that causes task creation to fail.

What To Do #

  • Use only the supported HTML tags listed above.
  • Instead of {all_fields}, selectively include the fields you need with individual merge tags.
  • If a specific field seems to cause errors (e.g., Signature), remove it from the description mapping.
  • If errors persist:
    • Try simplifying the description to plain text.
    • Enable Gravity Forms logging.
    • Contact support with the entry ID, description content, and error message.