🐛 Bug: Concurrent edits silently overwrite work item descriptions (lost images/text)
Maintainers usually reply within 1 day
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
Research direction
Start with IssueViewSet.partial_update in apps/api/plane/app/views/issue/base.py and the document type definition in apps/live/src/types/index.ts; trace how the editor autosaves descriptions and how page collaboration is handled. Compare the concurrency and collaboration options in the issue, then define how stale edits are detected or merged. Done means concurrent edits no longer silently discard another user's description content; verify with the two browser steps described above.
Written by the indexing model from the issue text.
Description
Is there an existing issue for this?
- I have searched the existing issues
Current behavior
When two people have the same work item open, the one who saves last silently overwrites what the other saved in the meantime, including newly added images. Nobody gets a warning and nothing is merged. The lost content only shows up in the description version history.
Why it happens
- The web editor autosaves the whole description with
PATCH /api/workspaces/<slug>/projects/<project_id>/issues/<id>/, sending{ "description_html": ... }. IssueViewSet.partial_update(apps/api/plane/app/views/issue/base.py) stores the receiveddescription_htmlas is. There is no version,updated_ator ETag check, so it is last-write-wins.- Work item descriptions are not collaborative. The live server only handles
project_pagedocuments (apps/live/src/types/index.ts:TDocumentTypes = "project_page"), so an open editor never receives other users' changes. Its next autosave writes its outdated copy back.
What we observed in production (self-hosted v1.4.2)
API logs with user ids, together with issue_description_versions, show this timeline on one work item (times in seconds, users A and B):
| t | event |
|---|---|
| 0 | B opens the work item (description has 4 images) |
| +9 s | A pastes a new image 6ef7e0ca… (asset upload + PATCH asset 204) |
| +11 s, +14 s | A's description autosaves (PATCH 204), image included |
| +69 s | B saves without having reloaded → 6ef7e0ca… is gone |
- The asset of the lost image was never deleted (
deleted_atis NULL, noDELETErequest). It was simply overwritten. - Earlier the same day, B's stale save also removed ~1,000 characters A had written a minute before (4,768 → 3,782 characters).
- In 3 weeks of logs we counted 26 saves made from a copy older than another user's latest save, on 7 work items. On one item, two users overwrote each other every few seconds for about a minute.
- The description history since 2025-08 contains more cases where an image added by one user disappeared after another user's save.
Steps to reproduce
- Open the same work item in two browsers as user A and user B.
- As A, add an image (or a paragraph) to the description and wait for the autosave.
- As B, without reloading, change anything in the description.
- Reload: A's image or paragraph is gone. The version history shows it existed in A's version.
Expected: A's change is kept (merged), or B is at least told that the description changed and is not allowed to silently overwrite it.
Possible directions
- Make work item descriptions collaborative through the live server, like pages (
description_binaryalready exists onIssue). This removes the problem at its root. - Optimistic concurrency as a smaller step: the client sends the version it started from (e.g.
updated_ator a hash ofdescription_html), the API returns 409 when it is outdated, and the editor refetches and reapplies the user's edit instead of overwriting. - Server-side merge as a stopgap. On our instance we now keep, per user and work item, the description the editor last loaded or saved. When the stored description changed since then, we apply the other users' changes onto the incoming HTML with a block-level 3-way merge (recursing into lists). If both sides changed the same block, both versions are kept. This has stopped the image loss for us. I'm happy to share the patch if it helps, but option 1 or 2 is clearly the better long-term fix.
Related: #9779 (realtime work-item updates for list/board views).
Environment
Production
Browser
Google Chrome
Variant
Self-hosted (Community)
Version
v1.4.2 (same logic on preview as of bab49bb)
- Dominant language
- TypeScript
- Stars
- 60.7k
- Forks
- 6k
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 79
Getting set up
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from makeplane/plane
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Maintainers usually reply within 1 day
-
[bug]: Email notifications show a broken avatar for users without a profile photoPossibly taken @gurnoorpannu claimed this 4 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
makeplane/plane#10009 · 1 comment ·
Maintainers usually reply within 1 day
-
🐛 Bug: Calendar work items cannot be opened on mobilePossibly taken @pennnnnnnnnn claimed this 6 days ago. Open
Difficulty 1/5 Under an hour Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
[bug]: First day of the week section not translated when Idioma is EspañolPossibly taken @deepcfr claimed this 9 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
makeplane/plane#9967 · 2 comments ·
Maintainers usually reply within 1 day
-
[bug]: First day of the week section not translated when Idioma is EspañolPossibly taken @Indira-kumar claimed this 6 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 1 day
Similar issues
-
The inspector never shows the instances field, so scaling out is unreachablePossibly taken @Mrkewl claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
xevrion/breakscale#96 ·
Maintainers usually reply within 4 days
-
Object parameters lose their structure when resources is enabledPossibly taken @asts-top claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Maintainers usually reply within 2 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
rossant/awesome-math#199 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
jaegertracing/jaeger-ui#4618 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
mifi/lossless-cut#3125 ·
Maintainers usually reply within 1 day