Skip to main content
Print

Connecting Dropbox

This guide connects your Dropbox account to Hera Backup. You create a Dropbox app, grant it a few file permissions, register the plugin's redirect URI, then authorize from WordPress. Authorizing gives the plugin a long-lived refresh token, which it uses to get a fresh access token whenever it needs one, so the connection does not expire.

Dropbox App Console wording is current as of 2026.

Before you start

  • Dropbox is part of the free Hera Backup plugin. Hera Backup Pro is not required.
  • A Dropbox account (free or paid).
  • Access to the Dropbox App Console: dropbox.com/developers/apps.
  • Keep your WordPress admin open in another tab: you copy a redirect URI between the two.

Step 1: Create a Dropbox app

  1. Go to dropbox.com/developers/apps and click Create app.
  2. Choose an API: select Scoped access.
  3. Choose the type of access:
    App folder (recommended): the app can only touch its own dedicated folder in your Dropbox.
    Full Dropbox: the app can access your whole Dropbox. Only choose this if you need backups stored outside the app folder.
  4. Enter a Name for your app (must be unique across Dropbox, for example Hera Backup <your-site>).
  5. Click Create app.

Step 2: Grant permissions (scopes)

  1. Open your app and go to the Permissions tab.
  2. Enable these scopes:
    account_info.read: the Test connection check and the connection status on the Dropbox card.
    files.metadata.read: listing the backups in the folder and checking that a backup file exists.
    files.content.write: uploading backups and deleting old ones.
    files.content.read: downloading a backup to restore it.
  3. Click Submit to save.

Hera Backup does not ask for particular scopes when you authorize: the connection gets the scopes enabled on this tab.

_Note: set permissions BEFORE authorizing. Adding a scope later does not apply to an existing authorization: you would have to reconnect._

Step 3: Copy your redirect URI from Hera Backup

  1. In WordPress, go to Hera Backup > Storages.
  2. Find the Dropbox card and click Connect (it reads Configure once the destination is connected).
  3. Below App key and App secret, copy the read-only Redirect URI (add to your Dropbox app OAuth 2 settings) field (click the field to select it). It looks like:

https://your-site.com/wp-admin/admin.php?page=hera_backup_storage&oauth_callback=1&driver=dropbox

Step 4: Register the redirect URI and copy app keys

  1. Back in the Dropbox App Console, open the Settings tab of your app.
  2. Under OAuth 2 > Redirect URIs, paste the URI from Step 3 and click Add. It must be HTTPS.
  3. On the same Settings tab, copy the App key and App secret.

_Note: redact the App secret before publishing._

Step 5: Enter keys and authorize in Hera Backup

  1. Return to the Hera Backup > Storages > Dropbox form.
  2. Enter:
    App key: from Step 4.
    App secret: from Step 4.
    Folder path: where backups are stored. The default is /Apps/HeraBackup/; if you leave the field empty, the plugin uses that default. Leave it unless you have a reason to change it.
    Max backups to keep (0 = unlimited): counted per schedule. When a scheduled backup finishes, that schedule's older backups here beyond this number are deleted. Manual and imported backups, the recovery point and the backup last restored are never deleted automatically. See Storage Retention and Cleanup.
  3. Click Save first. Hera Backup builds the Dropbox authorization address from the saved App key and completes the connection from your WordPress server with the saved App secret, so both must be saved before you authorize.
  4. Click Authorize with Dropbox.
  5. A Dropbox window opens. Click Allow to grant the permissions.
    Finish within 15 minutes, and keep open the Hera Backup tab you clicked the button in: that tab completes the connection. An authorization that takes longer than 15 minutes is refused, and you start again.
  6. The window closes, the settings page shows a success notice, and the form shows Connected. The connection is saved at this point: you do not need to click Save again. You will not need to reconnect unless you revoke access in Dropbox.

Step 6: Test the connection

  1. Click Test connection.
  2. Hera Backup uses the saved connection to get a fresh access token from Dropbox, then reads your Dropbox account info. No file is created during the test.
  3. A passing test shows Connection OK.

Where your backups are stored

Backups upload to the folder set in the plugin's Folder path field (default /Apps/HeraBackup/). Each backup is one .hera file, uploaded directly into that folder.

If you chose App folder access in Step 1, Dropbox reads the Folder path inside your app's own folder, and the app cannot see anything else in your Dropbox. With the default Folder path, your backups are therefore in an Apps/HeraBackup folder inside the app's folder. With Full Dropbox access, the Folder path is read from the top of your Dropbox.

What to expect

  • Dropbox becomes a destination for manual backups and schedules once connected.
  • Hera Backup builds each backup archive on your server first, then uploads it. Archives up to 150 MiB go up in one request. Larger ones go up in pieces of 8 MiB; a piece that fails for a temporary reason (no answer, a timeout, a rate limit or a Dropbox server error) is sent again, up to four tries.
  • Backups count against your Dropbox storage quota.
  • The connection stays authorized automatically via the refresh token; you only reconnect if you revoke the app in your Dropbox account settings.
  • Upload speed is usually limited by your server's outbound bandwidth.
Table of Contents