Troubleshooting
Your text is never thrown away when something goes wrong. Use Copy Markdown to keep a copy before retrying.
| Message | What it means and what to do |
|---|---|
| Jira rejected this content: … | Jira refused the content (for example it's too long, or a field rule failed). Read the reason after the colon, shorten or fix the content, and save again. |
| Your session has expired. Reload the page and try again. | Copy your Markdown, reload the Jira page, sign in if asked, then reopen the editor and paste. |
| You don't have permission to do this. | Your Jira permissions don't allow this change. Ask a project admin for edit or comment permission. |
| This issue or comment no longer exists. | It was deleted or moved. Copy your Markdown and reload. |
| This changed on the server. Reload to see the latest version. | Someone else changed it. Copy your Markdown, reload and merge your changes. |
| Jira is busy. Please try again in a moment. | Jira is rate-limiting requests. Markdown Studio already retried once; wait a few seconds and try again. |
| Something went wrong talking to Jira. Your text is safe. | A network or server problem. Select Retry, or copy your Markdown and reload. |
| This description changed while you were editing | Someone saved after you opened the editor. Choose Overwrite with my version, Copy my Markdown and reload, or Cancel to keep editing. |
| You don't have permission to edit this description, or it isn't on this issue's edit screen. | The editor is read-only. Ask an admin to grant edit permission or add Description to the edit screen. |
| Your Markdown Studio subscription isn't active. A Jira admin can renew it under Apps > Manage apps. | The licence lapsed or the trial ended. Preview and Copy still work. |
| Open an issue to use Markdown Studio. | The app was opened outside an issue. Open an issue first. |
| This content can't be saved yet: … | A safety check found a structural problem before sending anything to Jira. Copy your Markdown and contact support with the message. |
Notices in the editor
- "… items that Markdown can't show …": some content is shown as locked chips. See Preserved content.
- Custom column widths … will be reset: a table had custom widths, which Markdown can't keep.
- … saved as links: Markdown images become links, because new images can't be uploaded yet.
- Raw HTML is saved as plain text: Jira doesn't accept HTML.
- … saved as text checkboxes (☐ ☑) …: task items inside other lists can't be real tasks in Jira.
- … saved just after that block: a chip was put where Jira doesn't allow it.
- Jira's inline code can't also be bold …: extra formatting on inline code is dropped.