For the complete documentation index, see llms.txt. This page is also available as Markdown.

Syncing Many to Many Projects

This document provides best practices for handling many-to-many projects in Getint, where a single or multiple projects must synchronize with other target projects across apps.

The Sync many projects option is currently available for Jira, Azure DevOps, Monday.com, and Asana connections. When enabled, only these apps appear as the second side of the integration: Jira, ServiceNow, Azure DevOps, Monday.com, and Asana.

Choose the Sync Mode Before You Build the Integration.

If you do not tick Sync many projects while setting up the connection, that side of the integration stays locked to the single project you selected. The option cannot be enabled later, so adding a second project means building a new integration from scratch.

The reverse does work. An integration created with Sync many projects enabled can be reduced to a single project, although the interface continues to display the many-project layout and Item Routing has to be updated to match the new selection.

How to Sync Many Projects

  1. To synchronize multiple projects, begin by creating an integration as you normally would. Next, choose Jira as the connector on the left side.

  1. Next, either select an existing connection or create a new one. After the connection is set, you’ll see a checkbox labeled Sync many projects above the dropdown list.

  1. Select the projects you want to sync, then click Connect.

An X appears next to each project name. Click it to remove a project from the selection if you chose the wrong one.

  1. Select the counterpart application—in this example, Jira. Then repeat the previous steps to choose the projects you want to sync.

  1. Click Start with Mapping Types to map the work item types.

  1. After mapping issue types, you can start adding fields to them. At the time we’re publishing this article, the Quick Build feature is not available for many-to-many projects. You will need to map fields manually.

Defining Conditions in Items Routing

The next step is to define conditions, as routing refers to the path a work item takes across connected systems. By setting clear rules, you ensure Getint knows which project each incoming work item belongs to and what type it should have.

Please follow the next steps to set up the rules for syncing your items, and then review the subsequent configuration steps to confirm that transitions, field mappings, and workflows are properly aligned.

  1. Please select the project where the item will be routed and specify its issue type. In this example, we are configuring how items from the right side will sync into the corresponding project on the left.

  1. Choose the field that will trigger the sync. For example, click +Add New Field to add conditions across multiple fields. If all conditions are met, the item will sync to the project you are routing it to.

  1. Now repeat the same steps for the right side of the integration. In this case, you are defining how items from the left will sync into the corresponding project on the right as long as conditions are met.

  1. Click Apply to submit the changes, then save the integration. After that, test the integration to confirm that routing works correctly and items are syncing as expected.

Removing or Adding Projects to Existing Integrations

You may need to adjust the projects connected to an integration. This can involve adding new projects to expand its scope or removing existing ones to simplify or restructure it. Follow the steps below to make these changes:

  • Click the box for the side of the app you want to modify. You can choose either side, depending on your goal.

  • Use the dropdown list to browse your projects and add new ones. You can also remove projects from the integration by clicking the X icon next to the project name. This works the same way as when you added or removed projects during the initial setup.

  • Close the tab and save the integration to submit your changes.

Switching Between Single Project and Many Projects Syncs

The Sync many projects option can only be enabled while you are setting up the connection. Moving between the two modes works in one direction only.

Single project to many projects is not possible: An integration built without Sync many projects stays tied to the project selected on that side, and the checkbox is no longer available once the integration exists. To cover additional projects, create a new integration with the option ticked, then rebuild the type mappings, field mappings, and routing conditions. After testing the replacement, disable or delete the original integration.

Many projects to a single project does work: Follow the steps in the previous section and remove projects until one remains on that side. Two points to keep in mind:

  • The interface still looks like a many-project sync. The checkbox stays ticked, and the project field continues to behave as a multi-project selector, even though only one project is selected.

  • Item Routing has to be updated to reflect the change. Conditions that pointed to the removed projects no longer resolve, so review the rules on both sides and adjust them so that every work item routes to the remaining project.

Because the restriction only applies in one direction, tick Sync many projects during setup whenever there is a chance that more projects will join the sync later, even if you start with a single project on each side.

Conclusion

Managing integrations is not a one‑time task but an ongoing process. Whether you are adding new projects to expand collaboration or removing existing ones to simplify workflows, the key is to define clear routing conditions and test thoroughly. By carefully mapping fields, setting rules, and validating sync behavior, you ensure that work items flow correctly between systems.

Need more help? Visit our Help Center or reach out to support by clicking the chat bubble for direct assistance.

Last updated

Was this helpful?