Step-by-Step Guide: Create Your Own Jira App Without Coding
Welcome to AI Apps Builder for Jira. This guide will walk you through creating your own Forge app in just a few minutes — without writing any code.
With AI Apps Builder, you can use AI to generate custom apps, dashboards, issue panels, and reports that match your workflow
Before You Start
To deploy or redeploy an app created with AI Apps Builder, you must be a Jira site administrator for the target Jira site.
If you are not an admin, you can:
Use your own Jira site or a Jira Sandbox to generate and validate your app.
Share the app link with a Jira administrator for deployment.
For step-by-step instructions on the second option, see How to Move Forge Apps Built with AI Apps Builder to Another Jira Site.
Step 1: Start a Chat with AI
After installation, you can find AI Apps Builder in your Jira site under the Apps menu in the sidebar. Click AI Apps Builder to open it and start a chat with AI.
Or open the Web Version of AI Apps Builder in your browser.
You'll see a chat box ready for your prompt. Describe the app you want to build in plain English, or choose from the ready-to-use prompts below.
Step 2: Describe Your App Idea
Start by typing a clear description of what you want your app to do. The more specific your description is, the better AI Apps Builder can generate the right Forge app for Jira.
Before writing your prompt, decide what type of app you want to create:
🔧 Full Application
A full Forge app for Jira with custom logic and UI that appears in the Jira sidebar or pages.
Best for: complex workflows, internal tools, custom pages, or process management.
📊 Dashboard Gadget
A lightweight dashboard widget focused on reporting and visualization that appears on Jira dashboards. Best for: KPIs, sprint progress, team metrics, SLA summaries, and visual reports.
🧩 Issue Panel
A contextual UI element displayed inside a Jira issue. Best for: sprint progress, overdue subtasks, SLA status, related issues, or custom issue-level metrics.
Tip for Better Results
When describing your idea, include:
What data you want to show
What problem the app should solve
AI Apps Builder uses your description to generate app code, including UI, logic, and configuration.
Step 3: AI generates your own app
Click the button ➡️ or press Enter to submit your app idea.
Choose a name for your Forge app. Save the suggested name or edit it if needed, then click Save to continue.
AI generates an app for you.
Step 4: Deployment
After AI has built a custom app, click “Ready to deploy”.
You have two deployment options: Manual and Automatic.
Manual deployment
If you are deploying your own app manually for the first time, prepare your environment. Read this guide: Deploying Jira Apps with AI Apps Builder Using the Forge Installer
If you have installed the Forge installer with Node.js, the Forge CLI, and all dependencies, follow these steps:
Choose your Operating System and download the ZIP file.
Run Forge installer
Enter your Atlassian account email (e.g.,
your-email@company.com). You can copy and paste.
Enter your Jira domain (e.g.,
yourcompany.atlassian.net). You can copy and paste.
Enter your API Token
The API token is used only during deployment to deploy the Forge app to a Jira site. The token is not used to read Jira data, access issues at runtime, or collect analytics. After deployment is complete, the API token no longer affects how the app works.
To create an API token, follow these steps:
Click the link "Generate an API token from Atlassian Account Settings"
This opens Atlassian Account Settings in a new tab
Click "Create API token"
Enter a label like "AI Apps Builder"
Click "Create"
Copy the generated token.
Your app, created with the AI Apps Builder, runs on Atlassian Forge within Atlassian's secure environment. Before deployment, you can review all the scopes your app uses.
Automatic Deployment
Enter your API Token.
The API token is used only during deployment to deploy the Forge app to a Jira site. The token is not used to read Jira data, access issues at runtime, or collect analytics. After deployment is complete, the API token no longer affects how the app works.
To create an API token, follow these steps:
Click the link "Generate an API token from Atlassian Account Settings"
This opens Atlassian Account Settings in a new tab
Click "Create API token"
Enter a label like "AI Apps Builder"
Click "Create"
Copy the generated token.
Click "Test Connection" to verify everything works.
Your app, created with the AI Apps Builder, runs on Atlassian Forge within Atlassian's secure environment. Before deployment, you can review all the scopes your app uses.
Click “Deploy to Jira Cloud”.
Wait for the Deployment information.
Step 5: Improvement
You can improve your app in two ways:
Keep chatting with AI.
Download the generated code and share it with a developer.
Improvement by chatting with AI
Click the logo and open the AI Apps Builder sidebar.
Select the app to refine.
Describe changes or additions in the box.
To apply changes, click Redeploy application.
Improvement by sharing with a developer
Click the logo and open the AI Apps Builder sidebar
Select the app to refine.
Choose manual deployment and download the ZIP file with the generated code.
💡 Tips for Writing Effective Prompts
Follow these guidelines to help AI Apps Builder generate the most accurate and useful Jira apps or dashboards:
Be specific—include details such as required fields, date ranges, filters, and sorting rules.
Example: “Show issues updated in the last 14 days, sorted by priority and assignee.”Define the format – indicate how you want the data to appear: as a table, chart, heatmap, cards, or a timeline.
Specify data sources – mention where information should come from, such as Assets, issue fields, worklogs, or custom fields.
Consider user roles – request role-based views, like an executive summary for managers and a detailed report for team leads.
Validate before rollout – ask a Jira admin to review and approve your generated app or dashboard before deploying it organization-wide
Haven't used AI Apps Builder yet? You're welcome to try it then!
Have questions or want to see AI Apps Builder in action?
Feel free to meet with us — book a demo today!