Dropbox setup

This page walks you through connecting Customer Cloud Gallery to Dropbox. As with Google Drive, the plugin uses your own OAuth credentials from the Dropbox App Console — no third-party servers in between. Aimed at photographers who already store client photos in Dropbox and want them to appear on their WordPress site.

What you’ll learn

• How to create a Dropbox app with the right access type
• How to set the OAuth redirect URI and required scopes
• How to copy the App key and App secret into the plugin
• How to authorise the connection and confirm it works
• The two scope checkboxes that are easy to miss

Prerequisites

• The plugin installed and activated (see Installation)
• A Dropbox account that owns or has access to the photo folders you want to share
• A free Dropbox developer account (any Dropbox account can register apps — no separate signup)

Tutorial video

Video coming soon.

Step-by-step

1. Open the Dropbox App Console

Go to dropbox.com/developers/apps and sign in with the Dropbox account that holds your client photos.

2. Create a new app

1. Click Create app.
2. Choose Scoped access (the recommended modern API).
3. Choose access type:
   • Full Dropbox — recommended for client galleries, lets the plugin read any folder you point it at.
   • App folder — limits the plugin to a single auto-created subfolder (/Apps/<your-app-name>). Use this if you want hard isolation, but you’ll have to move galleries into that folder.
4. Name the app — anything works, e.g. “Customer Gallery”.
5. Click Create app.

3. Add the OAuth redirect URI

1. In WordPress, open Customer Cloud Gallery → Settings, scroll to the Dropbox section, and expand Dropbox — step-by-step. The plugin shows your exact redirect URI in a code block — copy it.

2. Back in the Dropbox App Console, on the Settings tab of your app, scroll to OAuth 2 → Redirect URIs.

3. Paste the URL and click Add.

   

4. Set the required scopes

1. Switch to the Permissions tab of your app.
2. Tick both:
   • files.metadata.read
   • files.content.read
3. Scroll to the bottom of the page and click Submit. This step is easy to miss. Without clicking Submit your scope changes are discarded and the OAuth flow will succeed but every API call will fail.

5. Copy App key and App secret into the plugin

1. Back on the Settings tab of your Dropbox app, copy the App key and the App secret (click Show to reveal the secret).

2. In WordPress at Customer Cloud Gallery → Settings, paste both into the Dropbox section.

3. Click Save credentials.

4. Click Connect Dropbox.

5. Dropbox shows its consent screen — approve.

   

Common mistakes

Connection succeeds but folder browser shows nothing. You forgot to click Submit on the Permissions tab after enabling the two scopes. Go back, tick the boxes, scroll down, click Submit, then click Disconnect in the plugin and Connect Dropbox again to refresh the token with the new scopes.

“App folder” access type and the plugin can’t find your photos. With “App folder” Dropbox creates a sandboxed /Apps/<app-name>/ folder and the plugin only sees what’s inside. Either move the photo folders there, or recreate the app with Full Dropbox access (recommended for galleries).

You expect more than 50 distinct end users. Dropbox apps in development mode are capped at 50 users (mostly relevant if you’re sharing the same plugin install across many photographers). The plugin’s normal photographer-and-clients use case never hits this — visitors don’t sign in to Dropbox, only the admin does.

Next step

Create your first gallery: First gallery. You can also connect Google Drive in parallel — see Google Drive setup — and choose the storage provider per gallery.