×

You're using an outdated browser

For a better experience, keep your browser up to date. Check here for the latest version.

Manual

Field Mappings

Liset de Bruin

Liset de Bruin Last update: Jul 15, 2019

Define which fields are synchronized between instances.Fields can be mapped either bi-directional or uni-directional if a field mapping is available. In general you can map fields of the same type to each other e.g. Summary to Summary. Other mappings might require a specific field mapping (transformation). Please refer to Field Reference for detailed information on which system fields are supported so far. The standard custom fields are also supported.

Please note that every field which should be edited by Backbone should be on the edit screen for this project and issue type combination. If you don't want this behavior, have a look at the advanced setting sync.editTransition.

Field Mapping 

If fields can be mapped to each other without further configuration you will be able to save in the first step of the create field mapping wizard. If not or if you want to customize the proposed mapping the next steps of the wizard will allow you to define the field mappings. For a select customfield you can for example map its single options there. Depending on your chosen directions, you will see one or both screens below.

After you've created a field mapping, you can see it in the list of field mappings. It is also possible to delete or edit an existing field mapping from here.

Info

Please note that you need the "Edit issues" permission for each project where you define incoming field mappings.

Speed it up with simple mappings

Speed things up with the simple mappings feature by adding multiple Field Mappings at the same time using a menu with checkboxes.

To open the simple mappings menu, click +Field mapping > Simple:

Now, a menu will appear where you can map all of a project's Fields with the corresponding Fields of the other project. You can select which Fields you wish to map using the checkboxes, and you can choose the direction of the synchronization using the dropdown list at the top of the screen.

After you have configured the mappings, click the create button and they will be configured on your synchronization.

Note

With the suggestions menu, you can only map a project's Fields with the same type of the other project (Description<>Description, Assignee<>Assignee etc.). If you want to map different Issue Types (e.g. Description<>Assignee) to one another, you have to do it manually.

Each time you use the Suggestions tool, you can only add synchronizations going in the same direction. If you want to add synchronizations going in more than one different direction, you have to use the tool multiple times.

Field Reference 

System Fields

This list shows which system fields are supported by Backbone. If you miss support for a certain field, please let us know via the support button.

For detailed information on how to synchronize some of the more complex mappings, refer to the field mapping reference.

Field Name

Supported?

Affects Version/s
Assignee
Attachment
Comment
Component/s
Created (read-only)
Creator (read-only)
Customer Request Type(tick)
Description
Due Date
Environment
Epic color(tick)
Epic link
Epic name(tick)
Epic status
Epic theme(tick)
Fix Version/s
Flagged(tick)
Images (this is not the Attachments field)Error (x)
IssueType(tick) (using advanced.issueTypeChangeAllowed advanced setting)
Key (IssueKey)

 (read-only)

Labels
Last Viewed (read-only)
Linked Issues
Log WorkError (x)
Multi-select fields(tick)
Multi-level cascading select(tick) (read-only)
Original Estimate
Priority
ProgressError (x)
ProjectError (x)
Project-specific select
Project-specific multi-select
Remaining Estimate
Reporter
Resolution
Resolved (read-only)
Request participants (read-only)
Satisfaction date(tick)
Security LevelError (x)
Select fields(tick)
Single version picker (read-only)
Sprint(tick)
Status (read-only)
Story points(tick)
Sub-Tasks
Summary
Time Spent (read-only)
Time TrackingError (x)
Updated (read-only)
Votes(tick) (read-only)
Watchers(tick)
Work RatioError (x)
∑ Original Estimate (read-only)
∑ ProgressError (x)
∑ Remaining Estimate (read-only)
∑ Time Spent (read-only)
2x$versions.current.name
We use cookies to create a secure and effective browsing experience for our website visitors and to understand how you use our site (i.e. Google Analytics). For more information: click here.
Ok