How can we help you?

Overview & Cloud Storage Architecture

The Gravity Forms Dropbox Integration Add-on connects your WordPress forms directly to your Dropbox cloud storage workspace via official Dropbox REST API v2 and OAuth 2.0 protocols. Whether you manage high-volume customer onboarding, creative design assets, legal contracts, job applications, or medical receipts, this integration automatically streams submitted attachments straight into organized Dropbox directories—completely bypassing WordPress local hosting storage.

Storing user file uploads on local WordPress web servers frequently triggers inode exhaustion, balloons site backup archives into tens of gigabytes, and causes upload failures due to strict server memory and execution limits. By offloading file handling directly to Dropbox, your WordPress infrastructure stays lightweight, secure, and lightning fast, while your team gains immediate real-time access to documents across desktop, tablet, and mobile Dropbox sync clients.

Step 1: Dropbox App Connection & OAuth 2.0 Authorization

Authenticating your WordPress site with Dropbox takes under sixty seconds using standard OAuth 2.0 authorization. You never have to manually copy-paste obscure app secrets or manage expiring access tokens—the add-on securely provisions and automatically refreshes tokens in the background.

1. In your WordPress administrative dashboard, navigate to Forms → Settings → Dropbox.
2. Click the Connect with Dropbox button.
3. You will be securely redirected to the official Dropbox authentication gateway. If prompted, log into your target Dropbox account.
4. Review the requested file access scopes (reading and writing files to your designated app folder or full Dropbox account) and click Allow.
5. Upon approval, Dropbox automatically redirects you back to your WordPress dashboard displaying a green Connected verification badge.

Figure 1: Streamlined OAuth 2.0 authentication establishing secure communication with Dropbox.

Step 2: Configuring Form Feeds & Subfolder Routing

Once authenticated globally, you can create one or multiple integration feeds on any form containing file upload fields. Feeds give you granular control over the destination directory, dynamic subfolder nesting, and file selection.

1. Navigate to Forms and hover over the specific form you wish to connect, then click Settings → Dropbox.
2. Click Add New to generate a fresh feed configuration.
3. Provide an administrative Feed Name (e.g. Client Onboarding File Sync).
4. Destination Folder: Specify the top-level Dropbox folder where files should land (for example, /Client-Uploads). If the folder does not exist yet, the add-on automatically creates it upon the first form submission.
5. Subfolder Organization: Check Enable Subfolder to partition incoming files into dedicated folders using live Gravity Forms merge tags.
6. File Upload Fields: Select All File Upload Fields or check individual fields selectively (such as Resume, Portfolio, or Government ID).
7. Click Save Settings to activate your feed.

Figure 2: Configuring Dropbox feed settings, subfolder paths, and file upload field routing.

Dynamic Subfolder Organization & Merge Tag Mapping

Dumping hundreds of uploaded files into a single root folder makes document retrieval chaotic. The add-on supports dynamic multi-level subfolder structures powered by Gravity Forms merge tags. You can combine form fields, entry IDs, dates, and static text to organize files instantly.

Chunked Streaming Uploads & Zero Local Storage Security

Standard WordPress file handling relies on PHP’s default move_uploaded_file() mechanism, which saves attachments into /wp-content/uploads/gravity_forms/. This introduces major operational and security vulnerabilities:

• Zero Local Footprint: When you enable the Purge Local Copy option in feed settings, the add-on immediately deletes the temporary local file as soon as the Dropbox API confirms receipt. Sensitive applicant credentials, financial statements, and medical records never linger on your shared hosting disk.
• Chunked Streaming Protocol: When users upload large files (high-resolution video footage, RAW photographs, multi-gigabyte ZIP archives), standard single-request HTTP uploads often crash with a 504 Gateway Timeout. The add-on employs Dropbox’s upload_session chunked API protocol, streaming files in segmented blocks with automatic retry logic to guarantee 100% upload completion.
• Entry Cloud Link Synchronization: In your WordPress entry management screen and form email notifications, local file paths are automatically replaced with direct, authenticated Dropbox cloud links, allowing your staff to preview documents instantly in the browser.

Figure 3: Uploaded client files organized directly inside the connected Dropbox cloud workspace.

Conditional Logic & Selective File Routing

You can execute Dropbox feeds conditionally based on user responses in the form. This eliminates redundant uploads and ensures files land in the right department’s cloud repository.

1. In your feed settings, scroll down to the Conditional Logic section.
2. Check Enable Condition.
3. Define your business rules (e.g. Process this feed if “Storage Preference” is “Dropbox Cloud” or Process if “Signed Contract” is not empty).
4. You can set up multiple feeds on the same form: for example, Feed A sends tax documents to /Finance/ when “Department” is “Accounting”, while Feed B sends creative portfolios to /Design/ when “Department” is “Creative”.

Developer Filters & Customization Hooks

Developers can programmatically modify file names, intercept storage paths, toggle local retention, or adjust API timeout thresholds before files dispatch to Dropbox.

Add custom filter hooks to your child theme’s functions.php or custom site plugin:

/**
 * Programmatically sanitize and prefix uploaded file names before Dropbox upload.
 *
 * @param string $file_name Original sanitized file name.
 * @param array  $form      The Gravity Forms form object.
 * @param string $field_id  The file upload field ID.
 * @param array  $entry     The current entry array.
 * @return string Modified file name.
 */
add_filter( 'gravityextra_dropbox_file_name', function( $file_name, $form, $field_id, $entry ) {
    // Prefix entry ID and clean timestamp to avoid duplicate name collisions
    $prefix = sprintf( 'Entry-%d_%s_', $entry['id'], date( 'Ymd-His' ) );
    return $prefix . sanitize_file_name( $file_name );
}, 10, 4 );

/**
 * Optionally retain a local copy on the web server for specific audit forms.
 */
add_filter( 'gravityextra_dropbox_store_local_version', function( $store_local, $file, $field_id, $form, $entry ) {
    // Retain local copy only if form ID is 12 (Audit Compliance Form)
    if ( $form['id'] === 12 ) {
        return true;
    }
    return $store_local;
}, 10, 5 );

Troubleshooting & Frequently Asked Questions

Related Resources & Live Demonstration