Dropbox is a file syncing and collaboration service with a generous free tier that allows you to move files between people and computers, keep a shared folder of files or store your work in the cloud. Apps and services can integrate with Dropbox to add extra functionality.

Podiant Professional users can use the Dropbox integration to automatically post episodes of their podcast, without using the Podiant website.

Before you begin, it's worth noting three things:

Podiant's Dropbox integration is still relatively experimental. It's useful as a convenience feature but shouldn't be used as your primary way of uploading content, unless in a pinch.
Podiant will create its own folder for temporarily storing episodes. Don't use this for permanent storage, as Podiant will delete episodes from within that folder to save storage space and to make it easier to keep track of the files that have already been published.
We do want to hear from you if you have problems with the Dropbox integration, but as it's an experimental feature, we may not be able to fix any issues straight away.

Enabling Dropbox

From the dashboard of the podcast you want to integrate with, select the "Podcast" menu and then click "Integrations".
Toggle the on/off switch next to "Dropbox" to the "on" position (it's off by default).
Login and authenticate with Dropbox, clicking the "Allow" button when you see it.

Navigate to your Dropbox folder on your desktop or using the website) and look for the Apps > Podiant folder. Inside that folder you should see a folder matching the subdomain of your podcast. For example, if your podcast's website is at myshow.podiant.co, you should see a folder called myshow.

Inside that folder is a subfolder named Episodes. We'll call this the episodes folder", and is where you'll upload new audio.

Preparing your podcast episode for upload

Podiant only supports MP3 files within Dropbox. When it's importing your content, Podiant reads the metadata of your MP3 stored in ID3 tags), and will extract the title, description and artwork, if present. If no artwork is used, the master podcast artwork will be used. If no specific title has been set within the MP3 file, it will be inferred from the filename.

You can use Markdown to add rich text to your shownotes, and save them into the Description or Comments section of your MP3 file's metadata.

Your audio software should let you specify this information when you export your episode. If not, you can use iTunes and certain other media player apps to edit the ID3 tags of your episode, before uploading.

All of the above is the case for publishing via mobile or desktop. Many recording apps support MP3 export and will let you specify the title, description and artwork before exporting.

Uploading your episode

Once you've exported your episode and added metadata, from a desktop computer:

Open your Dropbox folder (via the Windows Explorer, macOS Finder or file manager in Ubuntu).
Navigate to the Apps > Podiant > \[subdomain\] > Episodes folder.
Drag your finished MP3 file into the Episodes folder.
Once you see a green circle with a white checkmark beside your episode's filename, the episode will shortly be processed by Podiant.
Once the episode has been processed successfully, the file will disappear from the Episodes folder.

From within a mobile audio app, you should see a "Share to Dropbox" or "Export to Dropbox" option. The Dropbox extension within the app will then ask you to choose the folder to save to, and from here the instructions are much the same as on the desktop.

What happens after upload

After the file is uploaded to or synced with Dropbox, Podiant will begin processing the file, reading metadata and moving it to our own cloud storage. Once this has been done, the file will disappear from your Dropbox Episodes folder, to save space and to make it easier to keep track of episodes that have already been imported.

The "Date created" timestamp of the file you upload will be used as the publication date of the episode.

The episode should appear instantly in your Podiant dashboard, and then will shortly be added to your RSS feed.


Errors enabling the integration

If you encounter an error enabling the integration, contact our support staff, giving as much detail as you can about the errors you're receiving or the unexpected behaviour that's occurring.

You successfully upload a file but nothing happens

If you've completed the steps above, adding your file into the correct folder wait up to 15 minutes. Try deleting the file and exporting it again with a slightly different name. Drag that file into your Episodes folder and if, after 15 minutes, the file still hasn't disappeared - indicating it's been processed by Podiant - contact our support staff.

The file disappears from Dropbox but is not added to the feed

Shortly after the file disappears from Dropbox, it should be visible in your Podiant dashboard. If you don't see it, check your inbox or the notifications area within Podiant to see if there was an error message. If you don't see anything that makes sense, contact our support staff.

If the episode isn't visible at all, this may mean Podiant was unable to correctly read the audio file once it was saved to our own cloud storage. This might be because it is corrupt. If this happens, please contact our support staff, and if possible, supply a link to the original file that you dragged into your Dropbox folder. This will help diagnose any processing issues.

Known issues

There is currently an issue involving files that are shared from one Dropbox folder and moved to another, in a different account. If a colleague has provided audio, moving it directly into your Episodes folder may not work. Instead you may need to remove it from your Dropbox folder, rename it and then return it to the Episodes folder.
The Dropbox integration does not currently support MP3 chapters.
Was this article helpful?
Thank you!