Support & Documentation

Everything you need to get started with Bulk Issue Rewriter

Getting Started

1Install the App

Install Bulk Issue Rewriter from the Atlassian Marketplace. You'll need Jira administrator permissions to install apps.

2Get an AI API Key

The App requires your own AI provider API key. Choose one:

OpenAI: Get a key at platform.openai.com/api-keys
Anthropic: Get a key at console.anthropic.com/settings/keys

Note: API usage costs are charged by your AI provider based on your usage.

3Configure Settings

Open the App in Jira, go to the Settings tab, and:

Select your AI provider (OpenAI or Anthropic)
Paste your API key
Click Test to verify the connection

Your API key is stored securely in your browser and never sent to our servers.

4Start Editing

Enter a JQL query to find issues (e.g., project = MYPROJ AND status = Open)
Click Search to load matching issues
Select the issues you want to edit
Choose an operation (Rewrite, Translate, Summarize, etc.)
Add optional instructions
Click Generate AI Suggestions
Review the preview and apply changes

AI Operations

Rewrite/Rephrase

Improves clarity, tone, and readability while maintaining the original meaning. Great for:

Making technical content more accessible
Improving professional tone
Fixing grammar and style issues

Translate

Translates issue content to another language. Add instructions like "Translate to Spanish" or "Translate to Japanese".

Standardize

Applies consistent naming conventions and formatting. Useful instructions:

"Use sentence case for summaries"
"Start descriptions with a user story format"
"Add [CATEGORY] prefix to summaries"

Summarize

Condenses long descriptions into shorter, clearer versions while keeping essential information.

Expand

Adds more detail and context to brief issues. Useful for fleshing out minimal issue descriptions.

Find & Replace

AI-enhanced pattern matching. Examples:

"Replace 'client' with 'customer' throughout"
"Update all references to v1 to v2"
"Replace company name 'OldCo' with 'NewCo'"

Frequently Asked Questions

Is my data safe?

Yes. The App runs on Atlassian's secure Forge platform. Your Jira data stays within Atlassian. Your API key is stored only in your browser. Issue text is sent to your AI provider only when you generate suggestions.

How much does the AI cost?

AI costs depend on your provider and usage. OpenAI charges ~$0.01-0.03 per 1K tokens (roughly 750 words). A typical issue edit uses 500-2000 tokens. Check your AI provider's pricing page for current rates.

Can I undo changes?

The App doesn't have a built-in undo feature, but Jira maintains issue history. You can view and restore previous versions through each issue's History tab.

Why isn't my API key working?

Check that:

You selected the correct provider (OpenAI vs Anthropic)
The key is copied correctly with no extra spaces
Your API account has available credits/quota
The key hasn't been revoked or expired

Use the Test button in Settings to verify your connection.

What JQL queries can I use?

Any valid JQL works. Common examples:

project = MYPROJ
project = MYPROJ AND status = "To Do"
assignee = currentUser()
created >= -7d
labels = needs-review

Is there a limit on how many issues I can edit?

The App loads up to 50 issues per search. You can edit all selected issues in a single operation. Plan tiers have monthly edit limits.

Can I use this with Jira Data Center?

No, Bulk Issue Rewriter is only available for Jira Cloud. It's built on Atlassian Forge, which is a cloud-only platform.

Troubleshooting

Changes not appearing in Jira

Refresh the Jira issue page
Check that the operation completed successfully (green confirmation)
Verify you have edit permissions on the issues

AI suggestions are poor quality

Be more specific in your instructions
Try a different operation type
Process fewer issues at once for better results

App is slow

AI generation takes 5-15 seconds depending on the number of issues
Large batches take longer to apply
Check your internet connection

Contact Support

Need help?

We're here to help! Contact us through:

Email: [email protected]
Marketplace: Use the "Get Support" link on our Marketplace listing

Please include:

Your Jira Cloud URL
Steps to reproduce the issue
Any error messages you see
Screenshots if helpful