Deepblu Academy | Creating or Importing Dive Logs Using Subsurface
post-template-default,single,single-post,postid-21803,single-format-gallery,ajax_fade,page_not_loaded,,select-theme-ver-3.7,wpb-js-composer js-comp-ver-5.0.1,vc_responsive

Creating or Importing Dive Logs Using Subsurface

If you’re sitting on a stash of dive logs created with a dive computer that cannot synchronize directly with the Deepblu app (see Deepblu Connect-compatible dive computers), you can import them directly into Deepblu using Subsurface, a piece of open-source and free software! Subsurface is compatible with nearly all popular dive computers.

Note: As of September 2017, Deepblu also supports uploading UDDF data files. While you can upload UDDF files created by any software, we strongly recommend using Subsurface-generated UDDF files as third-party software may have different implementations that our systems don’t understand.

Before you begin

  1. Grab a desktop or laptop computer. There’s currently no app for that
  2. Download Subsurface from the Subsurface download page and install it on your system
  3. Connect your dive computer to your desktop or laptop computer (refer to the manual of your dive computer to learn how)
  4. Use the browser on your desktop or laptop computer to navigate to Deepblu and log in.

Collect your dive logs in Subsurface

  1. Open Subsurface, select Import from the menu bar and click on Import from dive computer from the dropdown menu
  2. Select the brand and name of your dive computer in the drop down list under Vendor & Dive Computer. Click the Download button
  3. Repeat this procedure if necessary until you have downloaded all your dive logs into Subsurface

Import Subsurface logs into Deepblu

Once you have all your dive logs collected in Subsurface, you can proceed to upload them to Deepblu.

  1. Open Subsurface, select File from the menu bar and then Export to get to the General Export tab
  2. Select Subsurface XML or UDDF and click OK. Remember where you save the file, you’ll need it in the next step
  3. Open the Deepblu tab in your browser (on your computer) and click the Create New Log icon next to your username at the top of the screen
  4. Select Upload Subsurface Logs
  5. On the next page, click the Choose File button. Select the XML or UDDF file you saved earlier and upload the file
  6. After the upload process finishes, you will receive a push notification telling you that we have received the data. Please wait up to 60 minutes (depending on workload and size of the data file) while we work on your data.
  7. When we’re done, you will receive a second push notification. Your dive logs are now accessible as drafts and you can edit and complete them with the Deepblu app or in your browser.


As with everything digital, errors happen from time to time. Here’s how to deal with the various error messages you may receive.

  • “This file is corrupt or not a valid Subsurface XML file. Please try again with the correct file format”: This means that the file may be damaged or was not generated using Subsurface. Try using Subsurface to export your dive logs and upload the file again. To be on the safe side, also make sure you have the latest version of Subsurface.
  • “We could not process your dive data, because it was not in a valid Subsurface-compatible XML or UDDF format”: While the file was successfully uploaded, our systems could not understand its content. Because some software uses a slightly modified UDDF format that our systems do not understand, please use Subsurface to generate your UDDF or XML files.
  • “We are processing your dive data. This may take up to 60 minutes. You will receive a notification when it’s done”: This is not an error message. We’re just processing your data. Depending on the size of the data file and the amount of work our systems are doing, the completion message will arrive within seconds or up to an hour.
  • “Something went wrong while processing your dive data”: Something unexpected happened on our end. Please send us an email at and include the data file (if the file is too large, please upload it to Dropbox or a similar file-sharing service and include the link). We will check what has gone wrong and help you migrate your data manually.

Was this article helpful?