Support
Support
Common problems, how to fix them, and how to reach us.
Troubleshooting
I can't find StoryCraft in the issue view.
StoryCraft is a collapsible section in the right-hand column of the issue, below Details. Scroll down and expand it. If it is missing, ask your Jira administrator to check that StoryCraft is installed under Apps → Manage apps.
The panel says "License Required".
StoryCraft needs an active license or trial. Click Manage License, or ask your Jira site administrator to check the subscription in Atlassian Administration.
StoryCraft says "Add a description first".
Apply Team Template and Refine Description work on the saved description. Write a few lines, save the issue, and try again. Clarify also works on issues without a description.
The result doesn't follow our team format.
Set a template for that issue type in the StoryCraft settings (Settings tab). Without one, StoryCraft uses a default structure; the panel then shows "Set a team template" under Apply Team Template.
The panel says "Template not found, fix in settings".
The template issue was deleted or you can no longer see it. Open the StoryCraft settings, click Remove broken link on that issue type, and choose a new template. The same applies to a broken example.
Generated text is too generic or uses the wrong terms.
Add a Project Context with your domain, stack and conventions, run a glossary scan, and set an example issue for the issue type. StoryCraft includes all of them in its requests.
The preview says "Preview may be incomplete".
The description contains content the AI and the diff can't fully handle, such as tables, info panels, code blocks, images or horizontal rules. Applying replaces the entire description, so check the result in Jira afterwards, or move that content to a comment first.
Bold text or links disappeared after I used Edit text.
Text you edit yourself is saved as plain formatting: headings, bullets and checklists are kept, rich formatting such as bold and links is not. Add it back in Jira after applying, or refine with an instruction instead of editing.
There is no Break into Stories button.
The button is only shown on issues of type Epic. Open the epic itself rather than one of its stories.
Creating a template fails with a permission error.
Choose & Create Template creates an issue in the project, so you need the Create Issues permission. Ask a project administrator to grant it, or pick an existing issue as the template.
Where is our data processed?
StoryCraft runs on Atlassian Forge and uses Atlassian-hosted AI. Your issues are not sent to a third-party AI provider. See the Privacy Policy for details.
Contact us
Can't find the answer here? We're happy to help.