How two-way sync works
What happens when you edit in Laya or in your connected tool, how changes travel in each direction, and how fresh to expect boards to be.
Last updated
On this page
Someone edits a work item — in Laya or in the connected tool (Jira, Azure DevOps, monday.com, GitHub or GitLab). Both directions are first-class: title, status, assignee, dates and more.
Laya keeps your boards and your existing tools in step in both directions. Connect Jira, Azure DevOps, monday.com, GitHub or GitLab and Laya streams a live, editable mirror of your boards. Nothing is migrated: your tool stays the system of record, and edits made on either side flow to the other.
One connection, two layers
Every integration follows the same shape:
- Connected boards are live mirrors. Each item on the external board appears as a card backed by a durable, synced copy in Laya — kept until you disconnect — so boards open instantly and update as changes arrive. Edits you make write straight back to your tool.
- Linked items are real Laya work items created when you import from a connected source. Each keeps a link to its external counterpart, and the pair stays in sync continuously.
- Master boards mirror every attached source's items as real Laya cards, so two-way sync works there exactly as it does for any imported item. See Master boards.
Not sure whether to mirror or import? Start with Mirror vs import and Native vs Connected vs both.
When you edit in Laya
Edits push to your tool immediately, as part of the edit itself. Renaming a card, dragging it to another column or changing a due date each fires a write to the provider straight away, and the result is recorded in the connection's Sync log.
Pushes are deliberately best-effort. If your tool is unreachable or rejects the write, Laya keeps your edit locally, records the failure, and lets the next inbound sync reconcile the two sides. A failed push never rolls back what you did in Laya.
When something changes in your tool
Changes flow back into Laya in three ways: instant push over a webhook, background polling, and manual sync. Laya sets the webhooks up for itself — when a board is connected it registers the hook with your tool, and boards connected earlier pick one up on their next sync. There is nothing to paste and no administrator to chase.
| Provider | Automatic updates | Manual |
|---|---|---|
| Jira | Webhook push, registered by Laya for you. Polling continues every 30 seconds as a safety net, and opening an item's side panel refreshes it on the spot. | Sync now |
| Azure DevOps | Service Hook push, registered by Laya for you. Polling continues every 60 seconds as a safety net, and opening a work item's panel refreshes that item on the spot. | Sync now |
| monday.com | Webhook push, registered by Laya for you. Polling continues every 60 seconds as a safety net. | Sync now |
| GitHub | Webhook push on repository boards, registered by Laya for you. A Project board spans repositories, so it stays on polling. Either way polling continues every 60 seconds as a safety net. | Sync now |
| GitLab | Project-hook push, registered by Laya for you. Polling continues every 60 seconds as a safety net. | Sync now |
Master boards add a Sync all boards action that live-pulls every provider attached to the board in one go and reports how many items were refreshed.
How fresh should boards feel?
- Laya → your tool: immediate. The write happens during your edit. Connections made through the installed Laya Board for Jira app queue the write and apply it within seconds.
- Your tool → Laya: a second or two on any board showing Instant updates, whichever tool it is — the change is pushed to Laya as it happens rather than waited for.
- On the regular sync: up to a minute, which is also the worst case if a push is ever missed. The poll never switches off, so nothing depends on a webhook staying healthy.
- Right now, either way: Sync now pulls immediately, and opening a card refreshes that card on the spot.
What mirroring means for your data
The connect flow puts it plainly: Laya keeps the board where it lives today 'and streams a live, editable mirror — nothing is migrated.' Concretely, Laya stores:
- A durable, synced copy of each mirrored item — title, status, assignees, dates and a link back to the original — kept until you disconnect, so boards open instantly. Comments are read live from the source rather than stored, and attachments are view-only (Jira) or copied only by a one-off import.
- For imported items, a real Laya work item plus a link record that keeps it paired with the original.
- Your connection credentials, encrypted at rest with AES-256-GCM. They are never displayed again in the UI or returned by the API.
Removing a mirrored board removes Laya's synced copy only: your tool is untouched, and you can re-mirror at any time. See Disconnecting safely for the full picture.
Email support@laya.net — include what you expected, what happened, and a link to the affected board or item so we can help quickly.