What is inside a Blackboard course export: res00001.dat, __xid files and where the real names are
You exported a course from Blackboard to keep your materials, unzipped it, and found imsmanifest.xml, a few hundred files named res00001.dat, res00002.dat… and a csfiles folder full of names like __xid-1482031_1.pdf. Your files are all there. This guide explains how the package is organized and how the names and folders can be put back.
Why the package looks like this
An export or archive package is made for Blackboard to read back in, not for people. Blackboard writes every object of the course (a menu entry, a folder, an item, an announcement, a setting) as a small XML file with a running number, and stores uploaded documents under the internal IDs of its file system. Nothing in the ZIP is named for a human.
| In the package | What it is |
|---|---|
imsmanifest.xml | The table of contents: the outline of the course (which item is in which folder) and a list of every res… resource with its type and title |
res00001.dat, res00002.dat, … | One XML file per object. An item’s file holds its title, its text and its list of attachments. Others hold settings, the gradebook, users, logs |
res00042/ (a folder next to the .dat) | Files that belong to that one object, such as images embedded in an item’s text or the picture of an Ultra learning module |
csfiles/home_dir/__xid-1482031_1.pdf | A document from the course’s file area (Course Files / Content Collection), stored under its ID |
csfiles/home_dir/__xid-1482031_1.pdf.xml | A small sidecar file with that document’s original path and name |
.bb-package-info | How the package was made: Blackboard version, course ID, export or archive |
Where the real file names are
Each name is written down twice. First, the item that links to the document lists it in its .dat file, with the internal ID in NAME and the name the course shows in LINKNAME:
<CONTENT id="_2203117_1"><TITLE value="Syllabus"/> …
<FILES><FILE id="_5120394_1">
<NAME>/xid-1482031_1</NAME>
<LINKNAME value="Syllabus.pdf"/><STORAGETYPE value="CS"/>
</FILE></FILES></CONTENT>Second, the sidecar next to the document in csfiles records where the file lived in the course’s file area:
<lom><relation><resource>
<identifier>1482031_1#/courses/BIO101_2026/Handouts/Syllabus.pdf</identifier>
</resource></relation></lom>The number is the link: xid-1482031_1 in the item, __xid-1482031_1 in csfiles, 1482031_1# in the sidecar. Images placed inside an item’s text are referenced the same way, as bbcswebdav/xid-1482031_1 in the HTML. The two names can differ slightly: when the same file was uploaded twice, Blackboard’s file area keeps a copy such as Syllabus(1).pdf while the course still shows Syllabus.pdf.
The folders come from imsmanifest.xml. Its <organization> section is a tree of <item> elements, each pointing to a res… file: the course menu entries at the top, the content folders (or Ultra learning modules) under them, and the items inside. Follow the tree and you have the course as you built it.
Let the browser do the lookups
Open the ZIP or the extracted folder. CourseUnpack reads the manifest, the .dat files and the csfiles sidecars, and gives you a new ZIP with your course folders and every document under its real name, plus index.html and manifest.csv. Nothing is uploaded. Free for the first 25 files, $9 once for all.
Unpack my courseExport vs. archive
Both are ZIP files with the same layout. The difference is what is included:
| Package | Usual name | Contains |
|---|---|---|
| Export | ExportFile_<course>_<date>.zip | The course content: menu, folders, items, files, tests, settings. No students |
| Archive | ArchiveFile_<course>_<date>.zip | Everything in an export, plus users, enrollments, grades, submissions, discussion posts and activity logs |
In the Ultra course view the two are one screen: Blackboard asks whether to include student activity data, and with it the export is an archive. An archive is a record of real people. If you only want your own teaching materials out of one, leave the gradebook, attempt and user files alone; CourseUnpack skips them and tells you they were there.
Anthology’s help is explicit about the package itself: “Don’t unzip a package or delete files from the package, as then the contents can’t be imported correctly.” So work on a copy, or use a tool that only reads the ZIP, and keep the original in case you need to import it into Blackboard again.
One date to know: Anthology states that the Original Course View will no longer be supported after December 31, 2026. If you have Original courses you want to keep materials from, export them while you still can.
What cannot be recovered
- Files that are not in the package. An item can link to a document that Blackboard did not include, for example a file that lives in another course or in an institution-wide folder, or when the package was made without the course’s file area. The name is still in the item, the file is not. CourseUnpack lists these in manifest.csv as missing.
- Tests as tests. Tests, surveys and pools are stored as QTI XML inside
.datfiles. They are meant to be imported into an LMS. CourseUnpack shows them in the outline and does not convert them. - Links to tools and other systems. Publisher content, videos hosted elsewhere and LTI tools are only links in the package.
- A running course. Getting your files out is not the same as restoring the course. For that, the package has to be imported into Blackboard, or converted for another LMS.
Doing it by hand, and other tools
For a handful of files you can do it yourself: unzip a copy, open csfiles/home_dir, and read the .xml next to each __xid file to see its name. The extension is usually still on the file, so you can also just open them one by one.
- BlackboardMoodleConverter: an open-source PHP application that converts an export package into a Moodle course, including documents, text, links and most test question types. You install it on a web server.
- blackboard-archive: a Python script that signs in to Blackboard and downloads the courses your account can see, with original file names. It needs a working login, so it is for before you lose access.
- Importing the package into another Blackboard course gives you the whole course back, if you have a Blackboard site where you can do that.
FAQ
Can I just rename the .dat files?
No. A .dat file is XML that describes an object; it is not a renamed PDF or Word file. Your documents are the __xid files in csfiles.
Some __xid files have no extension. What are they?
Usually images Blackboard generated or stored without a name, such as a course banner. The first bytes of the file tell the type; CourseUnpack adds .jpg, .png, .gif, .pdf or .webp when it recognizes one.
Does a package include student submissions?
An archive does, an export does not. CourseUnpack leaves submissions, grades and other student records out in both cases.
Sources
- Anthology Help: Export and Archive Courses (what an archive adds; “Don’t unzip a package or delete files from the package”)
- Anthology Help: Export and Archive Courses, Original Course View
- Anthology Help: Original Course View end-of-life timeline (December 31, 2026)
- kraebsli/BlackboardMoodleConverter: description of the export file structure