Clone Pro Documentation

Complete guide to installing, configuring, and using Clone Pro for Jira Cloud. Clone entire projects with smart text replacement across all issues in one operation.

Overview

Clone Pro is a Jira Cloud app that enables cloning entire projects with smart text replacement capabilities. Unlike single-issue cloning tools, Clone Pro handles your complete project structure — epics, stories, tasks, and subtasks — while replacing text across all cloned content.

Key Features

• Full project cloning — Clone all issues from a source project to a new project
• Hierarchical tree view — See and select issues at any level (Epic → Story → Subtask)
• Smart text replacement — Define multiple find/replace pairs applied across all issues
• Selective cloning — Filter by issue type, status, or use presets
• Hierarchy preservation — Parent-child relationships are maintained
• Components & versions — Clone project metadata along with issues
• Progress tracking — Real-time progress indicator during cloning
• Runs on Atlassian — Built on Forge, 100% hosted on Atlassian infrastructure

Use Cases

Clone Pro is designed for teams with repeatable project structures:

• Agencies — Clone client onboarding project templates, replacing client names throughout
• Consulting firms — Duplicate engagement structures for each new client
• Compliance teams — Copy SOC2/audit projects for new cycles
• HR/Onboarding — Create employee onboarding projects from templates
• Quarterly planning — Duplicate sprint structures, replacing Q1 with Q2 everywhere

Installation

Clone Pro can be installed from the Atlassian Marketplace by a Jira administrator.

Requirements

• Jira Cloud (Software, Service Management, or Work Management)
• Jira administrator permissions to install apps
• Project administrator permissions to clone projects

Installation Steps

1. Go to Jira Settings → Apps → Find new apps
2. Search for "Clone Pro"
3. Click Get app and follow the prompts
4. Once installed, Clone Pro is accessible from the global navigation or project settings

Quick Start

Get started with Clone Pro in under 5 minutes:

1. Open Clone Pro from the Apps menu or project settings
2. Select your source project from the dropdown
3. Review the issue tree — all issues are selected by default
4. Add replacement pairs — e.g., find "Acme Industries" → replace with "New Client Ltd"
5. Configure the target — enter new project name and key
6. Click Clone and watch the progress

Select Project

The first step is choosing which project to clone.

Project Selector

The project dropdown shows all Jira projects you have access to. You can:

• Type to filter the list
• See issue counts for each project
• Select any project regardless of type (Software, Business, Service Management)

Project Permissions

You must have at least "Browse Project" permission on the source project to clone it. To create a new target project, you need global project creation permissions.

Preview Contents

After selecting a project, Clone Pro loads and displays all issues in a hierarchical tree view.

Loading Issues

Clone Pro fetches all issues from the source project, including:

• All issue types (Epics, Stories, Tasks, Bugs, Subtasks, etc.)
• Parent-child relationships
• Epic-story links
• Issue metadata (status, priority, labels, etc.)

Issue Selection

The tree view lets you select exactly which issues to clone.

Tree View Controls

• Checkboxes — Click to select/deselect individual issues
• Expand/Collapse — Click the arrow to show/hide children
• Select parent — Automatically selects all children
• Deselect parent — Automatically deselects all children

Quick Actions

Text Replacement

Define find/replace pairs to update text across all cloned issues.

Adding Replacement Pairs

Click "Add replacement pair" to add a new find → replace rule. You can add as many pairs as needed.

Replacement Options

• Case insensitive (default) — Matches "Acme", "ACME", "acme", etc.
• Case sensitive — Only matches the exact case you enter
• Whole word — Prevents partial matches (e.g., "Project" won't match "Projects")

Fields Affected

Text replacement is applied to:

• Summary
• Description (including rich text/ADF content)
• Comments
• Custom text fields

Target Configuration

Configure where the cloned issues will be created.

New Project Settings

Project Key Rules

• Must be 2-10 characters
• Must be uppercase letters only
• Must be unique across your Jira instance
• Clone Pro validates the key before cloning

Tree View

The hierarchical tree view is the core of Clone Pro's interface.

Hierarchy Display

Issues are displayed in a parent-child hierarchy:

📁 Epic: Client Onboarding Framework
  ├── 📄 Story: Initial Setup
  │   ├── 📋 Subtask: Configure workspace
  │   └── 📋 Subtask: Set up credentials
  ├── 📄 Story: Data Migration
  │   ├── 📋 Subtask: Export data
  │   └── 📋 Subtask: Import data
  └── 📄 Story: Training

Visual Indicators

• Icons — Issue type icons match your Jira configuration
• Status badges — Current issue status shown as colored badges
• Selection state — Checked, unchecked, or partially selected (for parents)

Filters & Presets

Quickly filter which issues to include in the clone.

Issue Type Filter

Show or hide issues by type:

• Epic
• Story
• Task
• Bug
• Subtask
• Custom issue types

Status Filter

Filter by issue status:

• To Do
• In Progress
• Done
• Custom statuses

Presets

What Gets Cloned

Understanding exactly what Clone Pro copies to the new project.

Included

Not Included

Progress Tracking

Clone Pro shows real-time progress during the cloning operation.

Progress Indicator

• Progress bar — Visual percentage complete
• Issue counter — "Cloning issue 45 of 120"
• Current issue — Shows the issue currently being processed
• Time estimate — Approximate time remaining

Completion Summary

When cloning completes, you'll see:

• Total issues cloned
• Total attachments copied
• Total comments cloned
• Any errors or warnings
• Link to the new project

Permissions

Clone Pro requires specific Jira permissions to function.

App Permissions

User Permissions

• Source project — Browse Project permission required
• Target project — Create Issues permission (or project creation permission for new projects)

Limits & Performance

Clone Pro is designed to handle large projects efficiently.

Supported Project Sizes

Rate Limiting

Clone Pro respects Atlassian's API rate limits by:

• Batching API requests
• Automatic backoff and retry on rate limit errors
• Parallel processing where safe

Async Processing

For large projects, cloning runs asynchronously. You can close the browser and return later — the job continues in the background.

Troubleshooting

Clone Pro doesn't appear in the menu

1. Ensure the app is installed correctly (check with your Jira admin)
2. Refresh the page and try again
3. Check that you have the required permissions

Project selector is empty

1. Verify you have Browse Project permission on at least one project
2. Check that your Jira instance has projects (not just a blank instance)

Text replacement isn't working

1. Check that your search text matches exactly (including spaces)
2. Verify case sensitivity settings match your text
3. Ensure the text exists in supported fields (summary, description, comments)

Cloning is slow

1. Large projects naturally take longer — this is expected
2. Many attachments increase cloning time significantly
3. Network conditions between you and Atlassian may affect speed

Some issues weren't cloned

1. Check the completion summary for any errors
2. Verify you selected those issues in the tree view
3. Ensure you have permission to view those issues

Frequently Asked Questions