Sync Bridge for Jira Cloud

Using These Docs with AI (llms.txt)

📘 What you will learn here

On this page you will learn how to download the llms.txt index of this documentation and give it to an AI assistant, so its answers about Sync Bridge are based on the current documentation.


Sync Bridge publishes an llms.txt index of this documentation. It's a short Markdown file that lists every page with a one-line description, in the format AI assistants and tools expect (see llmstxt.org).

Use it when you ask an AI assistant, such as Rovo, Claude or ChatGPT, about Sync Bridge, so its answers are based on the current documentation.

Download

llms.txt (attached to this page)

How to use it

  1. Download llms.txt, or copy the content below.

  2. Give it to your AI assistant, for example by attaching the file or pasting the content into the chat, together with your question.

  3. If your assistant can open web pages, ask it to read the linked pages that are relevant to your question.

AI assistants can make mistakes. When an answer affects your sync rules or data, check it against the linked page.

Content

# Sync Bridge for Jira Cloud

> Sync Bridge is an Atlassian Forge app that keeps work items in two Jira Cloud sites in sync: fields, status, comments and attachments. Admins create a connector to the other Jira Cloud site and sync rules that define which work items sync, in which direction (Push only, Pull only, Both directions), and how fields and statuses map. Version 1.0 supports Jira Cloud ↔ Jira Cloud only. Some limits depend on the license edition (Evaluation, Standard, Advanced): how often scheduled pull runs, whether the Sync Trigger API is available, and how long sync history is kept.

Terminology: "work item" (Jira issue), "work type" (issue type), "space" (Jira project), "This Jira site" (the site where Sync Bridge is installed), "connector" (saved connection to the other Jira Cloud site), "sync rule" (what to sync and how), "license edition" (Evaluation for a trial, Standard or Advanced).

## Start here

- [Overview](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/overview): what Sync Bridge syncs, key concepts, how push and pull work
- [Installation Guide](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/installation-guide): requirements, install from Marketplace, permissions, trial and license expiry
- [License Editions](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/license-editions): what Evaluation, Standard and Advanced include (scheduled pull interval, Sync Trigger API, sync history retention, trial limits) and what happens on upgrade or downgrade
- [Getting Started](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/getting-started): first sync end to end

## Administrator Guide

- [Administrator Guide](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/administrator-guide): overview of the admin page
- [Dashboard](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/dashboard): sync health at a glance
- [Connectors](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/connectors): connect and test the other Jira Cloud site
- [Sync Rules](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-rules): what a sync rule is, the rule list
- [Create a Sync Rule](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/create-a-sync-rule): every step of the sync rule editor, including push and pull triggers and schedule limits per license edition
- [Field Mapping](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/field-mapping): map fields, directions, transform types
- [Smart Values and Transformations](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/smart-values-and-transformations): smart value syntax and full function catalog
- [Status Mapping](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/status-mapping): map statuses through workflow transitions
- [Comments Sync](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/comments-sync): comment events and filters
- [Attachments Sync](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/attachments-sync): attachment events, filters, limits
- [Duplicate, Import and Export Sync Rules](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/duplicate-import-and-export-sync-rules): copy rules within and between sites; copies are fitted to the license edition
- [Settings Locked After Work Items Are Synced](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/settings-locked-after-work-items-are-synced): which settings can't change once a rule has synced
- [Sync Rule Reference](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-rule-reference): every sync rule option with allowed values and defaults, plus the export/import JSON structure
- [Permissions and Per-Work-Item Sync Control](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/permissions-and-per-work-item-sync-control): who can configure, view and turn sync on or off
- [Sync History](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-history): admin view of all sync activity and retention (up to 6 months on Standard, 1 year on Advanced and Evaluation)
- [Search Synced Work Items with JQL](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/search-synced-work-items-with-jql): JQL fields for sync status, linked keys and rules

## User Guide

- [User Guide](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/user-guide): what users see on a work item
- [Sync Bridge panel](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-bridge-panel): sync status, linked work items, manual sync
- [Sync History tab](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-history-tab): per-work-item sync log
- [Turn Sync On or Off for a Work Item](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/turn-sync-on-or-off-for-a-work-item): pause or resume sync for one work item

## API

- [API Guide](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/api-guide): overview for integrators; the API needs the Advanced or Evaluation edition
- [API Tokens](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/api-tokens): create and revoke push and pull tokens
- [Sync Trigger API](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-trigger-api): push or pull one work item (`direction`), endpoint, authentication, request and responses (including 403 on Standard and 422 pull reasons), examples

## Use cases

- [Sync With a Customer's Jira Site](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-with-a-customers-jira-site)
- [Sync Two Internal Jira Sites](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/sync-two-internal-jira-sites)

## Optional

- [Troubleshooting](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/troubleshooting): find and fix sync errors
- [Current Limitations](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/current-limitations): fixed limits, including limits per license edition
- [Release Notes](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/release-notes)
- [FAQ and Support](https://mgm-atlassian-apps.mgm-tp.com/sync-bridge-for-jira-cloud/latest/faq-and-support): common questions, including which license edition you need