Attachments: How to Attach a PDF File via URL

You can attach a publicly accessible PDF link to a message in RapidPro so contacts can open documents directly from the message, which is useful for sharing guides, forms, policies, and other resources without uploading files.

Quickly attach a PDF link to a message

Use a PDF URL attachment to share documents directly from a message:

  1. Open a flow and add a Send Message action
  2. Open the Attachments tab
  3. Select PDF Document URL
  4. Paste a publicly accessible PDF link and save
  5. Test the link in the Simulator (and with a real message)

Step-by-Step Process

1
Open a flow and add a Send Message action

  1. Go to Flows.
  2. Open an existing flow (or create a new one).
  3. Add a Send Message action.

[CAPTURE: Flow editor showing a Send Message action.]

2
Open the Attachments tab

  1. In the Send Message action, click the Attachments tab at the top of the node.

[CAPTURE: Send Message action with the Attachments tab highlighted.]

3
Select PDF Document URL

  1. From the attachment type dropdown, choose PDF Document URL.

[CAPTURE: Attachment type dropdown with “PDF Document URL” selected.]

4
Paste the PDF link and save

  1. Paste the publicly accessible PDF URL into the field.
  2. Click OK to save.

[CAPTURE: PDF URL pasted into the attachment field.]

That’s it — the PDF link is now attached to your message.

5
Test the PDF attachment

  1. Open the Simulator.
  2. Trigger the flow.
  3. Click the attached PDF link to confirm it opens.

[CAPTURE: Simulator view showing a message with a PDF attachment.]

Best practice: Test PDF links in both the Simulator and real messages before sending to large audiences.

Common Issues & Quick Fixes

Problem: The PDF doesn’t open for contacts.

Possible causes: The URL is not public, the PDF requires authentication, or the link was mistyped.
Fix: Open the link in an incognito/private browser window to confirm it’s public, then re-check the URL and try again.

Problem: The attachment doesn’t appear in the message.

Possible causes: The attachment wasn’t saved, or the wrong attachment type was selected.
Fix: Reopen the Send Message action, confirm PDF Document URL is selected, and click OK to save.

Problem: The PDF opens in some channels but not others.

Cause: Channel or device limitations can affect how attachments are displayed or opened.
Fix: Test across your target channels/devices and add clear instructions in the message (for example, “Tap the link to open the document”).