Supported File Types and Sizes
Upload formats, size limits, and recommended image dimensions for previews, branding, and Create.
What This Is For
This page lists which file types Skillhabit accepts and the maximum size for each category when you upload in the product UI. Use it when preparing media, choosing a package for Create, or answering “why won’t this file upload?”
It does not walk through authoring steps—those live in Create and related guides linked below.
Who This Is For
- Collaborators and administrators uploading into Create (courses, Imported Package-type packages, programs, certificate attachments)
- Learners and reviewers who attach files to reflection answers or comments (where the course allows it)
- Anyone checking limits before a large video or package upload
Limits by Category
Sizes below are the ceilings enforced in the Create (and shared) upload UI. Stay under the limit for your category; larger files are rejected before upload finishes.
| Category | Max size | Accepted types | Typical use |
|---|---|---|---|
| SCORM / Tin Can / cmi5 packages | 2.5 GB | .zip with a manifest at the package root: imsmanifest.xml (SCORM 1.2 / 2004), tincan.xml (Tin Can / xAPI), or cmi5.xml (cmi5) | Import external courses in Create → Imported Package-type item |
| Video | 2 GB | Standard video formats (video/*—for example .mp4, .mov, .avi) | Video building blocks; also journey hotspot media |
| Audio | 100 MB | Standard audio formats (audio/*—for example .mp3, .wav) | Audio building blocks; also journey hotspot media |
| Images | 10 MB | .png, .jpg / .jpeg, .gif, .svg, .webp, .avif, .apng | Image building blocks, posters, journey images, branding-style pickers |
| Documents (course File element) | 100 MB | .pdf, .doc, .docx, .rtf, .xls, .xlsx, .ppt, .pptx, .zip, .txt, .xml, .yml | File building blocks learners can download |
| Video captions | 5 MB | .vtt (WebVTT) | Subtitles / closed captions on a Video element |
| Reflection attachments | 50 MB | .xlsx, .xls, .jpg, .jpeg, .png, .gif, .webp, .svg, .bmp, .avif, .heic, .heif, .doc, .docx, .ppt, .pptx, .txt, .pdf | Learner (and reviewer) file uploads on reflection questions that allow attachments |
| AI Course Studio source files | 10 MB | .pdf, .doc, .docx, .txt | Optional source uploads when drafting with AI Course Studio |
Certificate attachments (extra documents issued with a certificate) accept PDF, Word (.doc / .docx), plain text, PNG, and JPG. The certificate attachment picker does not surface a separate size label in the UI the way building-block uploads do—keep files modest and prefer the document/image categories above as a guide.
Recommended Image Dimensions
Skillhabit crops many uploads to a fixed aspect ratio. Prepare assets at (or above) these sizes so they stay sharp after crop. Smaller files still upload if they stay under 10 MB, but the cropper may upscale or look soft.
| Use | Recommended size | Aspect | Notes |
|---|---|---|---|
| Course / program / Imported Package-type / meetup preview | 1800 × 1000 | 9∶5 (1.8) | Content card and overview image in Create |
| Academy collection cover | 1800 × 1000 | 9∶5 (1.8) | Same ratio as content previews |
| Home welcome image | 2000 × 400 | 5∶1 | Configure → Customization → Welcome message |
| Academy storefront cover | 2000 × 400 | 5∶1 | Academy admin welcome / cover section |
| Brand logo | 2000 × 300 | Wide banner | Configure → Customization → Brand logo (no forced crop—prefer a logo that reads on a wide strip) |
| Registration page image | 1024 × 1024 | 1∶1 | Configure → registration path details |
| Course image building blocks | 1800 × 1000 (slideshow) or square (grid / image+text) | 9∶5 or 1∶1 | Depends on the element; the picker shows the crop shape |
| Video posters | 1280 × 720 | 16∶9 | Matches the in-course video frame |
Tips:
- Export PNG or JPEG for photos; SVG or PNG for logos when you need crisp edges.
- Keep important subject matter in the center—edges are most likely to be cropped on responsive layouts.
- Stay under the 10 MB image limit in Limits by Category.
Where Uploads Apply
| Place in the product | What you upload | Limits to use |
|---|---|---|
| Create → built-in course → Add element | File, Image (and image variants), Audio, Video | Documents, images, audio, video (+ captions on video) |
| Create → Imported Package-type item | SCORM / Tin Can / cmi5 .zip package | SCORM / Tin Can / cmi5 packages |
| Create → program learning journey hotspot | Image, video, or audio for hotspot media | Video / audio / image rows (UI allows a single high ceiling; stay within the category you are uploading) |
| Create → content Certificate issuance → Certificate attachments | Optional extra document on the issued certificate | Certificate attachments (types above) |
| Create → AI Course Studio | Optional PDF / Word / text sources | AI Course Studio source files |
| Learn → course Reflections (and Follow Up comments when files are allowed) | Learner or reviewer attachments | Reflection attachments |
Branding and welcome images in Configure use the shared image picker (10 MB, same image formats). Recommended pixel sizes for logos, welcome banners, and content previews are in Recommended Image Dimensions. How-tos: Branding and Welcome Banner.
Tips
- Prefer compressed video (for example H.264
.mp4) when approaching the 2 GB ceiling. - Package zips need a valid manifest at the root of the archive (
imsmanifest.xml,tincan.xml, orcmi5.xml)—not a nested folder-only package. Details: Imported Package (SCORM, Tin Can & cmi5). - A
.zipunder Documents is a downloadable file for learners; it is not the same path as importing an Imported Package-type package. - Large package uploads use TUS (resumable) so a dropped connection can continue; unpacking shows a percent (or Waiting in queue…). If processing fails, use Retry processing before re-uploading—see Uploading and Processing.
- If upload fails near the limit, check the file’s true size on disk and that the extension matches the category you are uploading into.
