Skip to main content
Support

Embedding Files

We host your images and files up to 5MB, and you can embed videos, PDFs and more. Use the /image, /file and /embed blocks in the article editor.

Taylor
Updated by Taylor
2 min read

You most certainly can! From .docx's to PDFs, you can pretty much embed anything you like. Here's how 👇

Media Files

We'll host all your images for you and you can embed videos directly from video services. You can also embed most things from the web like this Apple Podcast embeddable using the Embed Block 👇

Attaching Files

How you add a file depends on its size:

If you want to attach a file of any type smaller than 5MB you can do that with the File block in the article editor. It'll insert a link to the file and we'll host it on our servers.

  1. Head to your article
  2. Type /file and pick File
  3. Click Upload a file or drag and drop your file in

The link text is the file's name unless you type your own. You can also turn any link into a file: open the link and click Upload a file.

Don't try to upload a file larger than 5MB this way. The same 5MB limit applies to images.
Need your files to be very secure? Contact support and we can enable token authentication that ensures the files aren't publicly accessible

If your file's larger than a Tokyo skyscraper you'll need to host it somewhere else and embed or link to it in your doc. Type /embed to add an Embed Block and paste the link: Google Docs and any link that serves a PDF embed straight away, along with services like YouTube, Vimeo, Loom and SoundCloud. For anything else that gives you an HTML embed code, click Paste embed code instead.

If you'd rather link to a file like a Word document, host it somewhere else and link to it from HelpDocs. Just highlight your text, click the link icon in the toolbar that pops up, and paste the URL. We love Dropbox for this.

Pro tip for Dropbox users. If you're linking to a file from Dropbox change the dl=0 to dl=1 at the end of the URL. That way the file will start downloading for users right away instead of showing them a Dropbox preview page.

Can I Manage Files in HelpDocs?

There is no file manager (or access to FTP files) to organize or manage your files once uploaded. If you want further control over your file organization, your best bet would be to use third party image/file hosting.

If an image is hosted externally, the editor tells you where: its label shows Hosted at followed by the site it comes from 😊

What did you think of this doc?

Previous Shortcuts in the Block Editor Next Using the Decision Tree