> 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-manage-your-files-library.md).

# How to manage your files library

Upload files once, see where each one is used, replace a file without breaking your lessons, and add chapters and subtitles to a video

**Files** is the storage behind every course: videos, PDFs, e-books and downloads live here once, and lessons point at them.

Because a lesson plays whatever file it was given, uploading a better version is a matter of **replacing** that one file — every lesson that uses it follows along.

### 1. Open the Files library

In Shopify admin, open **Apps** -> **LDT Online Courses** (1a), then click **Files** in the app's sidebar. The bar at the top of the list shows how much of your plan's storage is in use.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-ab6608c8b323e5a6ed71c6f931b054575b857aa4%2Fhow-to-manage-your-files-library-step-1.png?alt=media" alt="Clicking Files in the app sidebar of the Shopify admin"><figcaption></figcaption></figure>

### 2. Start an upload

Click **Upload files** in the bar at the very top of the page — the same bar Shopify uses for the page's own actions.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-6f1a8cf6bd92cca83e65e1bfebc5365b9ad6e31e%2Fhow-to-manage-your-files-library-step-2.png?alt=media" alt="Clicking Upload files in the Shopify admin title row"><figcaption></figcaption></figure>

### 3. Add the files and their categories

The upload window takes the files themselves and the labels they should carry:

* **Add files** — click it, or drag files onto the box. Several files at once is fine.
* **Search category** — type a category name and pick it, so the new files land in the right group of your library immediately. The line under the box is the reminder of what categories are for: *Add categories to group your files & easily manage them.*
* **Replace file content if already exists** — tick this when you are uploading a new version of a file you already have. The new content takes over the old file's place instead of becoming a second file, so the lessons that use it keep working.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-238e1a33d3f5c76b4d6f13ad0126b2747772029e%2Fhow-to-manage-your-files-library-step-3.png?alt=media" alt="Adding files and categories in the Upload files window"><figcaption></figcaption></figure>

### 4. Find a file in the list

Every row answers "what is this and where does it live?":

* **System** and **Upload by student** split the library by who put the file there; student uploads are the ones that arrived from your storefront.
* **Search and filter** finds a file by its name — faster than scrolling once the library grows. **Export CSV** downloads the list as it is filtered.
* **File** is the name, followed by the course path the file is used in (*For dev -> M1 -> L1 -> Video*); a file that is not finished yet carries a **Processing**, **Upload error** or **Transcoding error** badge next to its name, and a file that fails the virus scan is blocked and cannot be played or attached to a lesson.
* **Categories** hold the labels you set while uploading, **Size** is the space the file takes (the figure in brackets is what its quality versions add), and **Public link** carries **Copy link** so you can paste the file's URL somewhere else.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-f5c7b7a94a713e6f8899bede80cdaa87e8f6c7d1%2Fhow-to-manage-your-files-library-step-4.png?alt=media" alt="Filtering the file list and reading the File, Categories, Size and Public link columns"><figcaption></figcaption></figure>

### 5. Open a file to see where it is used

Click a file's name. The page that opens carries the file name in the bar at the top and two actions: **Replace file** and **View file**.

The **Information** card holds the type, the size, **Created at** and **Updated at**, and, for a video that already has quality versions, **Delete original video file**. **Categories** shows the labels on this file, and **Used in** is the answer to "what breaks if I change this?" — the course, module and lesson that point at it.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-d862dca38900dacceabc6e844eb41c0ad2894b1f%2Fhow-to-manage-your-files-library-step-5.png?alt=media" alt="Reading the Information, Categories and Used in cards of a file"><figcaption></figcaption></figure>

### 6. Add chapters and subtitles to a video

Scrolling down the same page gives you the parts of a video that are not the picture:

* **Adaptive streaming & optimization** lists the quality versions the app generated (**1080p**, **720p**, **480p** with their sizes), lets you delete one, and carries **Generate quality version** to make more of them.
* **Chapters** — **Add chapter** takes a start time and a title, so students can jump to a section instead of scrubbing.
* **Subtitles** — **Add subtitle** takes a language and a subtitle file, one row per language; **Generate translations** turns a published subtitle into other languages with AI — see [How to translate subtitles with AI](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-translate-subtitles-with-ai.md).

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-fa2cee3666e13dcceaccee539b9a692ad3db502b%2Fhow-to-manage-your-files-library-step-6.png?alt=media" alt="Adding chapters and subtitles and managing quality versions of a video"><figcaption></figcaption></figure>

### 7. Replace a file with a new version

Open the file, click **Replace file** in the bar at the top, and confirm the warning — then the upload window opens to take the new content. The file keeps its name, its categories and its place, so every lesson that uses it plays the new version with no further edits.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-c908c7e434d6c1a19a6753dc492065e9b2e331b4%2Fhow-to-manage-your-files-library-step-7.png?alt=media" alt="Confirming the Replace file warning"><figcaption></figcaption></figure>

### Result

A file lives in one place, its lessons point at it, and you can see the whole picture for any file — where it is used, how big it is, which quality versions and subtitles it has — before you change it.

### Troubleshooting

* **I replaced a video and the subtitles are gone.** The replacement content has its own subtitles; re-upload them from the **Subtitles** card of the file.
* **A lesson still plays the old video.** Check **Used in** on the file you replaced — the lesson may point at a different file that happens to have the same name. **Search by name** in the file list shows both.
* **I want the storage back but I still need the video.** **Delete original video file** removes the source file and keeps the quality versions. It also warns you of the two consequences: keep your own backup, and you cannot generate another quality version afterwards.
* **A file shows no course path.** Nothing uses it yet — it is safe to keep for a later lesson, or to leave alone.
* **Uploading a second copy instead of replacing.** Tick **Replace file content if already exists** in the upload window, otherwise you get two files and the lessons keep pointing at the first one.
* **The storage figure looks out of date.** The number is read from the server, so a file you have just deleted still counts until the next read — **Refresh** on the **Pricing** page re-reads it.
* **A file is blocked.** Its **Status** is failed or infected; the app will not play it or attach it to a lesson. Upload a clean copy, then replace the file.
* **I need the list outside the app.** Use **Export CSV** on the file list; it follows the current filter and search.

### Related pages

* [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 a Downloadable PDF for Students](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-create-a-lesson-with-a-downloadable-pdf-for-students.md)
* [Why do my uploads keep failing?](https://helpdesk.ldtsoft.work/ldt-online-course/troubleshoot/why-do-my-uploads-keep-failing.md)
* [Is Your Video Taking Too Long to Process? Understand the Cause & How to Optimize](https://gitlab.com/trong-gitbook/online-course-gitbook/-/tree/main/faq/is-your-video-taking-too-long-to-process.md)
* [How to translate subtitles with AI](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-translate-subtitles-with-ai.md)
