Understanding what conflict.count indicator

Hey all! I’m seeking more information to understand the conflict.count API indicator. The description here says “Number of doc conflicts which need to be resolved manually.”

  • what does “doc conflict” mean? when does this occur?
  • what’s the process of resolving manually?


Hi Beth,

Document conflicts in CouchDB happen when there are multiple updates of the same document. CouchDB doesn’t know which update is the latest and captures the conflicting revisions within the document in the _conflicts field.

Conflicts mostly happen during replication where multiple clients can make updates to the same document and conflicts arise when syncing back to the server. The couch documentation site has a great explanation of replication and conflict resolution here:


There’s also a guide in CHT docs about database conflicts and how to manage them: