> For the complete documentation index, see [llms.txt](https://helpdesk.ldtsoft.work/ldt-online-course/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-create-a-lesson-with-a-downloadable-pdf-for-students.md).

# How to Create a Lesson with a Downloadable PDF for Students

Add a PDF students can read in the lesson or download

Upload the PDF to Files, then add a **PDF viewer** (read in the lesson) or a **Downloadable file** block (download only) to the lesson.

### 1. Upload the PDF

In the app, open **Files** and click **Upload files**. Choose the PDF and wait for the upload to finish. Open the file to check its size, thumbnail and **Used in** list.

![The PDF file detail with its thumbnail and usage](https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-904026f2fcf8cbedfe864923272fac48a558f439%2Fhow-to-create-a-lesson-with-a-downloadable-pdf-for-students-file.png?alt=media)

### 2. Add the PDF to the lesson

Open the course and lesson, scroll to **Contents** and click **Add new content**:

* **PDF viewer** — students read the PDF inside the lesson.
* **Downloadable file** — students get a file block they can download.

Pick the PDF from Files. You can add both if you want reading and download; each is a separate block.

![The lesson Contents with a PDF viewer and a Downloadable file block](https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-9d1b1e2c05528765a5ec7bf1f5efad45fb29a5cc%2Fhow-to-create-a-lesson-with-a-downloadable-pdf-for-students-contents.png?alt=media)

### 3. Configure the block and save

For **PDF viewer**, choose **PDF view mode** — **Single Page / Book pages** or **Continuous / Scrollable** — and optionally turn on **Show PDF page fit-width as default** and **Show download button**.

![The PDF viewer block settings: view mode, fit-width and download button](https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-2bc6346a7fe4c93ccca9506df547fabb9a7dac40%2Fhow-to-create-a-lesson-with-a-downloadable-pdf-for-students-block-settings.png?alt=media)

For **Downloadable file**, fill **Custom label** (optional) and upload a **Thumbnail** if you want a cover image. Save the lesson with the **Unsaved changes → Save** bar if it appears, then use **Preview**.

### Result

Students open the lesson and read the PDF inline or download it, depending on the block you added. The file stays in Files, so replacing it there updates the lesson without rebuilding the block.

### Troubleshooting

* **The PDF is not in the picker.** Finish the upload in **Files** and reload the lesson; only uploaded files appear.
* **The reader is blank or slow.** Large PDFs take longer to load; check the file opens in a browser and keep it reasonably compressed.
* **Students can read but not download.** Turn on **Show download button** in the PDF viewer, or add a **Downloadable file** block.
* **The download has the wrong name.** Rename the file in Files, or set a **Custom label** on the block.
* **The file was deleted.** The lesson block keeps the old reference and cannot play; upload the file again and select it.
* **The PDF looks cropped on mobile.** Try **Continuous / Scrollable** and **Show PDF page fit-width as default**.

### Related pages

* [How to manage your files library](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-manage-your-files-library.md)
* [How to Create a Lesson with Direct Video Upload](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-create-a-lesson-with-direct-video-upload.md)
* [How to Create a Lesson with an Ebook for Students](https://gitlab.com/trong-gitbook/online-course-gitbook/-/tree/main/course-management/how-to-create-a-lesson-with-an-ebook-for-students.md)
* [How to replace a file in a lesson](https://gitlab.com/trong-gitbook/online-course-gitbook/-/tree/main/course-management/how-to-replace-a-file-in-a-lesson.md)
