# Uploading a project
If you have a set of LaTeX files on a local machine, you can upload the entire set to create an Overleaf project. Local LaTeX documents that require multiple files (.tex, .bib, image files, and others) can be zipped and uploaded to Overleaf to create a project using the **Upload project** option under the New Project button.
## Uploading large projects
If you plan to upload large projects, here are some Overleaf resource limits/restrictions you need to be aware of:
* You cannot upload individual files which exceed 50 MB.
* Each upload can contain up to 180 files—if you attempt to upload more than that, only 180 files will be uploaded.
* Each Overleaf project cannot contain more than 2000 individual files.
If your project’s `.zip` file exceeds 50 MB you can try this:
* Upload a subset of your files in a `.zip` file (just to create the project).
* Manually upload the remaining files.
For a `.zip` file to upload properly:
* It should contain only file types that a LaTeX compiler can process: plain text files and images in `.eps`, `.pdf`, `.svg` and `.png` formats.
* It cannot contain more than 7 MB of material that can be edited on Overleaf (this is the maximum editable data for a project on Overleaf). For further information, please refer to [this page](/getting-started/free-and-premium-plans/plan-limits.md#overleaf-plan-limits).
## Troubleshooting project upload issues
If a project that compiles on your local machine fails to compile when uploaded to Overleaf, there are a few things you should check before moving on to general LaTeX troubleshooting.
### Ensure that your compiler is the right type for your project
By default, the compiler will be set to be **pdfLaTeX.** Some projects and templates may require the use of another compiler type (**LaTeX**, **LuaLaTeX** or **XeLaTeX**). [Selecting a TeX Live version and LaTeX compiler](/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler.md)
### Check that your project's TeX Live version is compatible with your LaTeX code
When you create a new project in Overleaf, the TeX Live version will be set to the latest available version. Some projects and templates may require the use of an older version of TeX Live. [Selecting a TeX Live version and LaTeX compiler](/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler.md)
### Select the correct main document
Overleaf will attempt to automatically detect the main document, but you should check that the correct `.tex` file has been designated as the main document. [The Main document](/getting-started/recompiling-your-project/the-main-document.md)
### If all files (including your main document) are in a top-level folder, move them out
Sometimes all the files in a zip are under a top-level folder, which can cause problems for Overleaf's compile process. If all your files are in a folder, move the files (and subfolders) out so that your main document is not in a folder. [The Main document](/getting-started/recompiling-your-project/the-main-document.md)
### If you are still seeing errors...
If your project is using the right compiler, a compatible TeX Live version, and has a correctly specified main document that is not in a folder, you'll have to take a closer look at any remaining errors that are being reported in order to identify the problem that is occurring. [Fixing LaTeX errors](/troubleshooting-and-support/fixing-latex-errors.md)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.overleaf.com/managing-projects-and-files/uploading-a-project.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.