Send POM Forms uploads to Google Drive
A Google Drive Upload field sends visitor files to a folder available to the connected Google account. Use it when the approved workflow owns its files in Drive rather than as local POM Forms uploads.
Requirements
Prepare:
- WordPress administrator access
- A Google Cloud project
- Google Drive API enabled in that project
- An OAuth 2.0 client with application type Web application
- A Google account with permission to add files to the destination folder
- The destination folder ID
Google’s current references cover the Drive API, OAuth for web server applications, Drive uploads, and usage limits.
Create the OAuth client
- Open Google Cloud Console and select the intended project.
- Enable Google Drive API.
- Configure the Google Auth Platform consent information required for the project.
- Create an OAuth 2.0 client.
- Select Web application.
- In WordPress, open Settings → POM Theme → Integrations → Google Drive.
- Copy the exact Authorized redirect URI shown by POM.
- Add that URI under the Google client’s authorized redirect URIs.
- Copy the client ID and client secret.
The redirect URI must match exactly. Use the production site’s displayed value when connecting production.
Connect the Google account
- Return to Settings → POM Theme → Integrations → Google Drive.
- Enter OAuth Client ID.
- Enter OAuth Client Secret.
- Save the theme settings.
- Choose Connect Google Drive.
- Sign in with the account that should receive form uploads.
- Approve the requested Drive permission.
- Return to WordPress and choose Test connection.
The screen also provides Reconnect account and Disconnect. In a multisite installation, configure the connection on the site that owns the form.
Keep the client secret private. Do not put it in a form field, page, source repository, screenshot, or support message.
Find the folder ID
Open the destination folder in Google Drive. A folder URL resembles:
https://drive.google.com/drive/folders/1AbCDefGhIjKlMnOpQrStUvWxYz
Copy only:
1AbCDefGhIjKlMnOpQrStUvWxYz
The connected account must be able to add files to that folder.
Add the upload field
- Open Forms → All Forms and select the form.
- In Builder, add Google Drive Upload.
- Set Label, Name, and Upload Prompt.
- Paste the folder ID into Drive Folder ID.
- Decide whether the field is Required.
- Configure Multiple Files when appropriate.
- Set the necessary size, MIME-type, and file-count restrictions.
- Optionally configure:
- Prepend to File Name
- Append to File Name
- Remove Original File Name
- Save the form.
The field is available only when Google Drive is configured. The current builder uses a manual folder ID; it does not provide a folder picker.
Set safe limits
The default maximum for a Google Drive field is 100 MB. A field can set a more restrictive size and an allowed MIME list. If the list is empty, POM still blocks dangerous script or executable extensions.
Google Drive service availability and quotas also apply. Keep limits as narrow as the workflow permits and explain them in the field’s help text.
Drive uploads are independent of local Store Uploaded Files. When POM submission storage is enabled, the stored entry can include the verified Drive file information and view link. Drive files remain remote and are not attached to notification emails as local files.
Verify before launch
- Run Test connection.
- Open the active form while signed out.
- Upload one small permitted file.
- Confirm it appears in the selected Drive folder.
- Confirm the submitted file name is represented correctly in any required notification.
- When submission storage is enabled, review the entry under Forms → Submissions.
- Test a prohibited type, an oversized file, and multiple files when enabled.
- Repeat from the production domain.
Resolve common problems
Connection test fails
Confirm the Drive API is enabled, the redirect URI is exact, and the saved OAuth client belongs to the same Google Cloud project. Use Reconnect account after correcting credentials.
Folder cannot be used
Copy the folder ID again and confirm the connected account can add a normal file to that folder.
The file is rejected
Review the field’s maximum size, MIME types, and file count. Try one small permitted file before broadening any limit.
Upload progress does not complete
Check the Drive connection and Google service status, then test without browser extensions or network policies that might block Google Drive traffic.
Remote Drive files are not automatically deleted when a later form action fails. Include Drive in the organization’s access and retention process.