[{"data":1,"prerenderedAt":481},["ShallowReactive",2],{"blog-post-docs\u002Fupload-your-files":3,"sibling-dives-docs\u002Fupload-your-files":306,"learn-track-docs\u002Fupload-your-files":307,"learn-prereq-docs\u002Fupload-your-files":308,"learn-docs-groups":309},{"id":4,"title":5,"authors":6,"body":7,"breadcrumb":6,"builders":6,"byline":6,"category":288,"categoryName":289,"challenge":6,"courseAuthor":6,"courseLead":6,"dek":6,"description":290,"draft":291,"extension":292,"eyebrow":6,"featured":291,"finish":6,"fork":6,"group":6,"groupName":6,"hero":6,"heroAlt":6,"heroCta":6,"heroImage":6,"homepageFeatured":291,"kind":293,"lessonCount":6,"meta":294,"navigation":295,"newsItems":6,"next":6,"ogImage":6,"order":296,"outcomes":6,"path":297,"prerequisite":6,"prerequisiteLinks":6,"publishDate":298,"readingTime":6,"related":299,"relatedProjects":6,"section":6,"seo":300,"spotlight":291,"stem":303,"tags":304,"track":6,"trackName":6,"updates":6,"__hash__":305},"blog\u002Fblog\u002Flearn\u002Fdocs\u002Fupload-your-files.md","Uploading your own files",null,{"type":8,"value":9,"toc":279},"minimark",[10,14,19,47,50,109,113,124,160,164,235,239,242,250,254],[11,12,13],"p",{},"Upload existing code when you create a project, or add it to a project you already have. Both take single files, a whole folder, or one archive.",[15,16,18],"h2",{"id":17},"start-a-project-from-your-files","Start a project from your files",[11,20,21,22,26,27,30,31,34,35,38,39,42,43,46],{},"Click ",[23,24,25],"strong",{},"New Project",", and under ",[23,28,29],{},"Project shape"," choose ",[23,32,33],{},"Upload your own files",". Drag files, a folder or an archive onto the card, or pick them with ",[23,36,37],{},"Files…"," or ",[23,40,41],{},"Folder…",". Once the files are read, the card shows the file count, the total size, and whether the project will run as Python or as JS. Then click ",[23,44,45],{},"Create",".",[11,48,49],{},"When you create a project from an upload:",[51,52,53,79,90,103],"ul",{},[54,55,56,59,60,64,65,68,69,72,73,78],"li",{},[23,57,58],{},"Your files decide the runtime."," A top-level ",[61,62,63],"code",{},"index.html"," and ",[61,66,67],{},"main.js"," make a JS project. Otherwise, a top-level ",[61,70,71],{},"main.py"," makes a Python project. ",[74,75,77],"a",{"href":76},"\u002Flearn\u002Fdocs\u002Fruntime-environment#python-or-js-project","The runtime environment"," explains the rule. If the upload has neither, the card warns you. You can still create the project and add an entry point later.",[54,80,81,59,87,89],{},[23,82,83,86],{},[61,84,85],{},"README.md"," becomes the write-up.",[61,88,85],{}," is not stored as a file. It becomes the project's write-up, the text on the Project Card. It can be up to 65,000 characters. A longer one is refused before anything is created.",[54,91,92,98,99,46],{},[23,93,94,97],{},[61,95,96],{},"requirements.txt"," is added if it is missing."," Without one, the project gets the same single Qiskit line a new Python project starts with. Add your own packages to it later. See ",[74,100,102],{"href":101},"\u002Flearn\u002Fdocs\u002Fruntime-environment#libraries","Libraries",[54,104,105,108],{},[23,106,107],{},"An archive is unpacked."," If you upload a single archive, the project is built from the files inside it.",[15,110,112],{"id":111},"add-files-to-an-existing-project","Add files to an existing project",[11,114,115,116,119,120,38,122,46],{},"In edit mode, switch the Code tab to the file tree view. The upload area sits at the bottom of the file list. Drop files, a folder or an archive onto it, or click ",[23,117,118],{},"Browse"," and choose ",[23,121,37],{},[23,123,41],{},[51,125,126,138,152],{},[54,127,128,131,132,38,135,46],{},[23,129,130],{},"Qollab asks before it unpacks an archive."," For a single archive, you choose ",[23,133,134],{},"Unpack",[23,136,137],{},"Upload as a file",[54,139,140,143,144,147,148,151],{},[23,141,142],{},"If the project already has files, Qollab asks what to keep."," ",[23,145,146],{},"Keep and add"," leaves the existing files in place. An uploaded file replaces an existing file at the same path, and the dialog lists which ones. ",[23,149,150],{},"Erase first"," deletes every file in the current version, then uploads. Erasing cannot be undone, so Qollab asks you to confirm.",[54,153,154,159],{},[23,155,156,158],{},[61,157,85],{}," is skipped here."," The write-up already has its own row in the file list. Open that row, or the Project Card, and paste the text there.",[15,161,163],{"id":162},"what-gets-uploaded","What gets uploaded",[51,165,166,200,213],{},[54,167,168,143,171,174,175,174,178,181,182,185,186,181,189,192,193,181,196,199],{},[23,169,170],{},"Archives:",[61,172,173],{},".zip",", ",[61,176,177],{},".tar",[61,179,180],{},".tar.gz"," (or ",[61,183,184],{},".tgz","), ",[61,187,188],{},".tar.bz2",[61,190,191],{},".tbz2",") and ",[61,194,195],{},".tar.xz",[61,197,198],{},".txz","). They are unpacked in your browser.",[54,201,202,205,206,209,210,212],{},[23,203,204],{},"A single wrapping folder is removed."," When everything sits inside one top-level folder, as in a ",[61,207,208],{},"my-project-main\u002F"," zip from GitHub, the files land at the top of the project. That puts ",[61,211,71],{}," where the runtime looks for it.",[54,214,215,143,218,221,222,221,225,174,228,231,232,46],{},[23,216,217],{},"Clutter is left out:",[61,219,220],{},".git"," folders, ",[61,223,224],{},"__MACOSX",[61,226,227],{},".DS_Store",[61,229,230],{},"Thumbs.db",", and files whose names start with ",[61,233,234],{},"._",[15,236,238],{"id":237},"limits","Limits",[11,240,241],{},"A project holds up to 100 files of up to 2 MB each, and all your projects together can use 200 MB. An upload that would go over any of these is refused as a whole, before anything is written, and the message says what went over. The same goes for paths the project cannot use: a path that is too long, or one where a file and a folder would share a name.",[11,243,244,245,249],{},"A dataset larger than 2 MB cannot be a project file. ",[74,246,248],{"href":247},"\u002Flearn\u002Fdocs\u002Fruntime-environment#larger-datasets","Larger datasets"," explains how to read one from the web instead.",[15,251,253],{"id":252},"related","Related",[51,255,256,261,267,273],{},[54,257,258],{},[74,259,77],{"href":260},"\u002Flearn\u002Fdocs\u002Fruntime-environment",[54,262,263],{},[74,264,266],{"href":265},"\u002Flearn\u002Fdocs\u002Fpython-qiskit-projects","Python \u002F Qiskit projects",[54,268,269],{},[74,270,272],{"href":271},"\u002Flearn\u002Fdocs\u002Fjs-qiskit-projects","JS \u002F Qiskit projects",[54,274,275],{},[74,276,278],{"href":277},"\u002Flearn\u002Fdocs\u002Fwrite-your-project-page","Editing your project",{"title":280,"searchDepth":281,"depth":281,"links":282},"",2,[283,284,285,286,287],{"id":17,"depth":281,"text":18},{"id":111,"depth":281,"text":112},{"id":162,"depth":281,"text":163},{"id":237,"depth":281,"text":238},{"id":252,"depth":281,"text":253},"projects","Projects","Start a project from files you already have, or add files, a folder or an archive to an existing one.",false,"md","doc",{},true,5,"\u002Fblog\u002Flearn\u002Fdocs\u002Fupload-your-files","2026-09-27",[],{"title":301,"description":302},"Uploading your own files · Qollab docs","How to create a Qollab project from your own files, folder or archive, and how uploading into an existing project works: archives, README.md, overwrites and limits.","blog\u002Flearn\u002Fdocs\u002Fupload-your-files",[],"kkkKrtbUhA3qPcqJ2aVO_xOw-SqW9eDkdcnVMNrjmsI",[],[],[],[310,317,331,359,458,468],{"category":311,"categoryName":312,"articles":313},"account","Account",[314],{"title":315,"href":316},"Account and profile","\u002Flearn\u002Fdocs\u002Faccount-and-profile",{"category":288,"categoryName":289,"articles":318},[319,322,323,326,329],{"title":320,"href":321},"The project page","\u002Flearn\u002Fdocs\u002Fproject-anatomy",{"title":278,"href":277},{"title":324,"href":325},"Publishing and versions","\u002Flearn\u002Fdocs\u002Fpublish",{"title":327,"href":328},"Forking a project","\u002Flearn\u002Fdocs\u002Ffork-and-remix",{"title":5,"href":330},"\u002Flearn\u002Fdocs\u002Fupload-your-files",{"category":332,"categoryName":333,"articles":334},"running-code","Running code",[335,338,341,342,343,344,347,350,353,356],{"title":336,"href":337},"Running your code","\u002Flearn\u002Fdocs\u002Frun-your-code",{"title":339,"href":340},"Compute backends","\u002Flearn\u002Fdocs\u002Fcompute-backends",{"title":77,"href":260},{"title":272,"href":271},{"title":266,"href":265},{"title":345,"href":346},"How your circuit is compiled","\u002Flearn\u002Fdocs\u002Fhow-your-circuit-is-compiled",{"title":348,"href":349},"Error mitigation and debiasing","\u002Flearn\u002Fdocs\u002Ferror-mitigation",{"title":351,"href":352},"Transpilation","\u002Flearn\u002Fdocs\u002Ftranspilation",{"title":354,"href":355},"Primitives","\u002Flearn\u002Fdocs\u002Fprimitives",{"title":357,"href":358},"Ideal vs. noise-model simulators","\u002Flearn\u002Fdocs\u002Fideal-vs-noise-model-simulators",{"category":360,"categoryName":361,"articles":362},"gates","Gates",[363,366,371,374,377,380,383,386,389,392,395,398,401,404,407,410,415,418,421,424,427,430,433,436,441,444,449,452,455],{"title":364,"href":365},"Gate reference","\u002Flearn\u002Fdocs\u002Fgates",{"title":367,"href":368,"group":369,"groupName":370},"H gate","\u002Flearn\u002Fdocs\u002Fh-gate","single-qubit","Single-qubit gates",{"title":372,"href":373,"group":369,"groupName":370},"X gate","\u002Flearn\u002Fdocs\u002Fx-gate",{"title":375,"href":376,"group":369,"groupName":370},"Y gate","\u002Flearn\u002Fdocs\u002Fy-gate",{"title":378,"href":379,"group":369,"groupName":370},"Z gate","\u002Flearn\u002Fdocs\u002Fz-gate",{"title":381,"href":382,"group":369,"groupName":370},"S gate","\u002Flearn\u002Fdocs\u002Fs-gate",{"title":384,"href":385,"group":369,"groupName":370},"Sdg gate","\u002Flearn\u002Fdocs\u002Fsdg-gate",{"title":387,"href":388,"group":369,"groupName":370},"T gate","\u002Flearn\u002Fdocs\u002Ft-gate",{"title":390,"href":391,"group":369,"groupName":370},"Tdg gate","\u002Flearn\u002Fdocs\u002Ftdg-gate",{"title":393,"href":394,"group":369,"groupName":370},"√X gate","\u002Flearn\u002Fdocs\u002Fsx-gate",{"title":396,"href":397,"group":369,"groupName":370},"√X† gate","\u002Flearn\u002Fdocs\u002Fsxdg-gate",{"title":399,"href":400,"group":369,"groupName":370},"P gate","\u002Flearn\u002Fdocs\u002Fp-gate",{"title":402,"href":403,"group":369,"groupName":370},"RX gate","\u002Flearn\u002Fdocs\u002Frx-gate",{"title":405,"href":406,"group":369,"groupName":370},"RY gate","\u002Flearn\u002Fdocs\u002Fry-gate",{"title":408,"href":409,"group":369,"groupName":370},"RZ gate","\u002Flearn\u002Fdocs\u002Frz-gate",{"title":411,"href":412,"group":413,"groupName":414},"CX gate","\u002Flearn\u002Fdocs\u002Fcx-gate","two-qubit","Two-qubit gates",{"title":416,"href":417,"group":413,"groupName":414},"CY gate","\u002Flearn\u002Fdocs\u002Fcy-gate",{"title":419,"href":420,"group":413,"groupName":414},"CZ gate","\u002Flearn\u002Fdocs\u002Fcz-gate",{"title":422,"href":423,"group":413,"groupName":414},"CP gate","\u002Flearn\u002Fdocs\u002Fcp-gate",{"title":425,"href":426,"group":413,"groupName":414},"Swap gate","\u002Flearn\u002Fdocs\u002Fswap-gate",{"title":428,"href":429,"group":413,"groupName":414},"RXX gate","\u002Flearn\u002Fdocs\u002Frxx-gate",{"title":431,"href":432,"group":413,"groupName":414},"RYY gate","\u002Flearn\u002Fdocs\u002Fryy-gate",{"title":434,"href":435,"group":413,"groupName":414},"RZZ gate","\u002Flearn\u002Fdocs\u002Frzz-gate",{"title":437,"href":438,"group":439,"groupName":440},"CCX gate","\u002Flearn\u002Fdocs\u002Fccx-gate","multi-qubit","Multi-qubit gates",{"title":442,"href":443,"group":439,"groupName":440},"Pauli evolution gate","\u002Flearn\u002Fdocs\u002Fpauli-evolution-gate",{"title":445,"href":446,"group":447,"groupName":448},"GPi gate","\u002Flearn\u002Fdocs\u002Fgpi-gate","native","IonQ native gates",{"title":450,"href":451,"group":447,"groupName":448},"GPi2 gate","\u002Flearn\u002Fdocs\u002Fgpi2-gate",{"title":453,"href":454,"group":447,"groupName":448},"MS gate","\u002Flearn\u002Fdocs\u002Fms-gate",{"title":456,"href":457,"group":447,"groupName":448},"ZZ gate","\u002Flearn\u002Fdocs\u002Fzz-gate",{"category":459,"categoryName":460,"articles":461},"credits","Credits",[462,465],{"title":463,"href":464},"How credits work","\u002Flearn\u002Fdocs\u002Fhow-credits-work",{"title":466,"href":467},"Before you spend credits","\u002Flearn\u002Fdocs\u002Fbefore-you-spend-credits",{"category":469,"categoryName":470,"articles":471},"troubleshooting","Troubleshooting",[472,475,478],{"title":473,"href":474},"Troubleshooting and FAQ","\u002Flearn\u002Fdocs\u002Ffaq",{"title":476,"href":477},"Error reference","\u002Flearn\u002Fdocs\u002Ferror-reference",{"title":479,"href":480},"Why your results look wrong","\u002Flearn\u002Fdocs\u002Fwhy-your-results-look-wrong",1790607255676]