diff --git a/.github/badges/tests.svg b/.github/badges/tests.svg
index 390300b87..1defd0b51 100644
--- a/.github/badges/tests.svg
+++ b/.github/badges/tests.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="110.2" height="20"><linearGradient id="smooth" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="round"><rect width="110.2" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#round)"><rect width="36.8" height="20" fill="#555"/><rect x="36.8" width="73.4" height="20" fill="#97CA00"/><rect width="110.2" height="20" fill="url(#smooth)"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><text x="194.0" y="150" fill="#010101" fill-opacity=".3" transform="scale(0.1)" textLength="268.0" lengthAdjust="spacing">tests</text><text x="194.0" y="140" transform="scale(0.1)" textLength="268.0" lengthAdjust="spacing">tests</text><text x="725.0" y="150" fill="#010101" fill-opacity=".3" transform="scale(0.1)" textLength="634.0" lengthAdjust="spacing">381 passed</text><text x="725.0" y="140" transform="scale(0.1)" textLength="634.0" lengthAdjust="spacing">381 passed</text></g></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="134.89999999999998" height="20"><linearGradient id="smooth" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="round"><rect width="134.89999999999998" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#round)"><rect width="36.8" height="20" fill="#555"/><rect x="36.8" width="98.1" height="20" fill="#dfb317"/><rect width="134.89999999999998" height="20" fill="url(#smooth)"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><text x="194.0" y="150" fill="#010101" fill-opacity=".3" transform="scale(0.1)" textLength="268.0" lengthAdjust="spacing">tests</text><text x="194.0" y="140" transform="scale(0.1)" textLength="268.0" lengthAdjust="spacing">tests</text><text x="848.5" y="150" fill="#010101" fill-opacity=".3" transform="scale(0.1)" textLength="881.0" lengthAdjust="spacing">377/381 passed</text><text x="848.5" y="140" transform="scale(0.1)" textLength="881.0" lengthAdjust="spacing">377/381 passed</text></g></svg>
\ No newline at end of file
diff --git a/src/ndi/+ndi/+cloud/+internal/createRemoteDatasetDoc.m b/src/ndi/+ndi/+cloud/+internal/createRemoteDatasetDoc.m
index cb5fef7f6..df166537a 100644
--- a/src/ndi/+ndi/+cloud/+internal/createRemoteDatasetDoc.m
+++ b/src/ndi/+ndi/+cloud/+internal/createRemoteDatasetDoc.m
@@ -1,14 +1,19 @@
-function remoteDatasetDoc = createRemoteDatasetDoc(cloudDatasetId, ndiDataset)
+function remoteDatasetDoc = createRemoteDatasetDoc(cloudDatasetId, ndiDataset, options)
 % createRemoteDatasetDoc - Create NDI document with remote dataset details.
 % 
 % Syntax:
-%   remoteDatasetDoc = createRemoteDatasetDoc(cloudDatasetId)
+%   remoteDatasetDoc = createRemoteDatasetDoc(cloudDatasetId, ndiDataset)
+%   remoteDatasetDoc = createRemoteDatasetDoc(cloudDatasetId, ndiDataset, 'replaceExisting', true)
+%
 %   This function retrieves a remote dataset from the cloud and creates 
 %   a "dataset remote" NDI document for that dataset.
 % 
 % Input Arguments:
 %   cloudDatasetId - The unique identifier for the cloud dataset to be 
 %                    retrieved.
+%   ndiDataset - The NDI dataset object.
+%   options.replaceExisting - A boolean that if true, will replace an
+%                       existing remote dataset document.
 % 
 % Output Arguments:
 %   remoteDatasetDoc - A document object containing the remote dataset 
@@ -17,6 +22,17 @@
     arguments
         cloudDatasetId
         ndiDataset (1,1) ndi.dataset
+        options.replaceExisting (1,1) logical = false
+    end
+
+    [~, existingDoc] = ndi.cloud.internal.getCloudDatasetIdForLocalDataset(ndiDataset);
+
+    if ~isempty(existingDoc)
+        if options.replaceExisting
+            ndiDataset.database_rm(existingDoc{1}.id());
+        else
+            error('An existing remote dataset document was found. Use ''replaceExisting'', true to replace it.');
+        end
     end
 
     [success, remoteDataset] = ndi.cloud.api.datasets.getDataset(cloudDatasetId);