dropbox

Dropbox File Conflict Explained

Resolution Checklist

  • 1 Understand what a Dropbox Conflicted Copy is
  • 2 Common scenarios that trigger file conflicts
  • 3 Find and list conflicted copies on Windows
  • 4 Find and list conflicted copies on macOS
  • 5 Step-by-step methods to resolve and merge conflicts
  • 6 Summary Quick Reference Checklist

Dropbox File Conflict Explained

A Conflicted Copy is a file created by Dropbox when the sync engine detects conflicting edits to the same file path and cannot automatically merge them. Rather than overwriting one person’s changes with another’s, Dropbox preserves both: it keeps the original filename for one version and appends the device name, username, and “conflicted copy” to the other.

This guide explains the mechanics of file conflicts, how to locate them, and how to safely resolve and merge them on Windows and macOS.

1. What Triggers a Conflicted Copy?

Dropbox will create a conflicted copy in the following scenarios:

  1. Simultaneous Edits: User A and User B open document.docx and edit it at the same time. When User A saves, their file is synced. When User B saves, Dropbox detects that User B’s starting version is outdated and saves User B’s file as document (User B's conflicted copy).docx.
  2. Offline Editing: User A edits a file while offline. Meanwhile, User B edits and syncs the same file online. When User A reconnects, their offline edits are uploaded as a conflicted copy.
  3. Local App Locks: An application (like Microsoft Word) keeps a file open and locked locally. When another user pushes an update from the cloud, Dropbox cannot overwrite the locked local file, resulting in a conflicted copy once the local lock is released.

2. Find and List Conflicted Copies on Windows (PowerShell)

Before merging, you need to locate all conflicted files in your Dropbox directory. Run this PowerShell command to output a list of conflicted copies sorted by their last modified date.

  1. Open PowerShell (Start Menu > type PowerShell).
  2. Run this command: 
    # Scan for conflicted copies and display them in a table
Get-ChildItem -Path "$HOME\Dropbox" -Recurse -File | Where-Object { 
    $_.Name -like "*(conflicted copy)*" 
} | Select-Object Name, LastWriteTime, Length, FullName | Format-Table -AutoSize

To export this list to a CSV file on your Desktop:

Get-ChildItem -Path "$HOME\Dropbox" -Recurse -File | Where-Object { $_.Name -like "*(conflicted copy)*" } | Select-Object Name, LastWriteTime, FullName | Export-Csv -Path "$HOME\Desktop\Conflicted_Files_Log.csv" -NoTypeInformation

3. Find and List Conflicted Copies on macOS (Terminal)

On macOS, you can use the Terminal to locate and list all conflicted copies along with their modification times.

  1. Open Terminal (via Cmd + Space, type Terminal).
  2. Run this command to list all conflicted copies: 
    # Find all files with 'conflicted copy' in the path, ordered by modification date
find ~/Dropbox -type f -name "*(conflicted copy)*" -exec ls -lt {} +

To output the paths to a text file on your Desktop:

find ~/Dropbox -type f -name "*(conflicted copy)*" > ~/Desktop/Conflicted_Files_Log.txt

4. Step-by-Step Methods to Resolve and Merge Conflicts

Once you have identified the conflicted files, use this workflow to resolve them:

Step 1: Compare and Merge the Content

Dropbox cannot merge data within files (e.g., text, spreadsheets, images). You must do this manually:

  • Text or Code Files: Use a diff tool like VS Code, WinMerge (Windows), or Meld (macOS) to compare the original file and the conflicted copy, merging the code or text blocks.
  • Word/Excel Documents: Open both files in Microsoft Office and use the Compare and Merge feature to review changes.
  • Binary Files (Images, PDFs): Visually inspect which file is correct. Rename the preferred one to the main filename.

Step 2: Delete the Conflicted Copy

Once you have merged the changes into the main file, delete the conflicted copy.

  • Windows (PowerShell): 
    Remove-Item -Path "C:\Users\username\Dropbox\path\to\file (conflicted copy).docx" -Force
  • macOS (Terminal): 
    rm "~/Dropbox/path/to/file (conflicted copy).docx"

Step 3: Prevent Conflicts with File Locking

If you are on a Dropbox Team or Professional plan, prevent conflicts by locking files:

  1. Right-click the file in your local Dropbox folder.
  2. Select Lock file (or Lock Editing).
  3. Other users will see that the file is locked and will not be able to sync changes to it until you unlock it.

5. Summary Quick Reference Checklist

StepAction TargetBest PracticeRecommended Tool
1. FindLocate conflict filesRun search scripts in PowerShell / TerminalGet-ChildItem (Win) / find (macOS)
2. CompareAnalyze differenceCompare files side-by-sideVS Code, WinMerge, Office Compare
3. MergeCombine editsConsolidate changes into a single main fileManual merging / copy-pasting
4. PurgeDelete redundant copiesDelete the file with “conflicted copy” suffixWindows Explorer / Finder
5. LockPrevent recurrenceLock editing on shared files before starting editsDropbox “Lock file” feature