# Import a Project

{% hint style="info" %}

**Recap**\
You have [created a Snyk account](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/getting-started/quickstart/create-a-snyk-account) and [integrated with your source code (Git) repository](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/getting-started/quickstart/set-up-an-integration) to allow access to your code for scanning. You can now run scans.
{% endhint %}

**Snyk Projects** are items that Snyk scans for issues, for example, a manifest file listing your open-source dependencies.

When you import a Project, Snyk scans that imported Project, and displays the results for you to review.

The following video shows how to import a Snyk Project:

{% embed url="<https://thoughtindustries-1.wistia.com/medias/9hwr0bnvko>" %}
Video demonstration of importing projects via the Snyk Web UI
{% endembed %}

The steps to import a Project are as follows:

* Select **Projects** > **Add Project,** and select where to import the Project from, for example, select GitHub to import from your GitHub repository, or select **CLI** to use the [Snyk CLI](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/snyk-cli) locally:

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2F5Ih0ZQeU7bbBlVzcfMCL%2FScreenshot%202022-07-26%20at%2010.06.54.png?alt=media&#x26;token=c294d625-12b3-41d3-b75a-136b3dfc0315" alt="Add Project choices"><figcaption><p>Add Project choices</p></figcaption></figure>

* Select the repositories to use, then choose **Add selected repositories** to import the selected repositories into your project:

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fgit-blob-c1b87cca2ed1c2f8a319e55283ec61616a1adb6d%2Fimage%20(4).png?alt=media" alt=""><figcaption><p>Add selected repositories</p></figcaption></figure>

{% hint style="info" %}
Projects you select to import are shown with a ![Check mark in check box](https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fgit-blob-7ca8a12c6d946dcfdeef89a257a27c13152cf185%2Fimage%20\(7\).png?alt=media).\
Projects previously imported are marked by a ✔.\
Private repositories are marked with a![Padlock](https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2F9E0VNFCqSVxu8uSuCPus%2FScreenshot%202023-05-11%20at%2023.05.30.png?alt=media\&token=ade1da6f-fb1e-4d2a-8cb5-60776fade58a).\
Forked repositories are marked with a ![Fork symbol](https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2FJD5Purx0s5HwEnJt35Bo%2FScreenshot%202023-05-11%20at%2023.15.46.png?alt=media\&token=cc340dd1-a2f8-459f-9da6-b1105c2021f1)
{% endhint %}

## Project import settings

In **Settings**, optionally choose to:

* **Add custom file location** to add any additional dependencies from custom paths.
* **Exclude folders** to list up to 10 folders to exclude from scanning during the import; for example, to shorten scanning time.

## Import progress

A progress bar appears during import. Select **View last import log** to see log results.

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2FS6EJ9DAT4C8tPx4sUO9M%2FScreenshot%202023-01-23%20at%2013.23.59.png?alt=media&#x26;token=c47f99a5-8323-4362-8283-ee275a6fb021" alt="Import Projects progress and option to view import log"><figcaption><p>Import Projects progress and option to view import log</p></figcaption></figure>

During the import, Snyk starts scanning the selected repos for relevant files (such as **package.json** files listing dependencies) in the entire directory tree, and imports these files as Snyk Projects.

## Import results

Project import completes, with a status message:

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2FYfbEtAT4NOjaZGXC34aK%2FScreenshot%202023-01-23%20at%2013.24.35.png?alt=media&#x26;token=5660c8d1-224e-4c1d-98e3-51a0a402fa1c" alt="Project import success message"><figcaption><p>Project import success message</p></figcaption></figure>

You have now successfully imported and scanned the selected Project.

{% hint style="success" %}
If you see any errors during import, see [Project import errors](https://support.snyk.io/hc/en-us/articles/360001373118).
{% endhint %}

## Additional benefits of importing a Project

Importing a Project also does the following:

* Sets Snyk to run a regular scan on that Project for issues ([daily by default](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/snyk-admin/manage-settings/usage-settings#projects)).
* Initiates some automations, especially default Snyk tests on pull and merge requests, which help prevent vulnerabilities from being added to the Project. This automation fails builds according to your conditions and can be disabled or customized in your [integration settings](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/integrations/git-repository-scm-integrations).

{% hint style="info" %}
For training on best practices using automations, visit the Snyk Training course: [Source Code Manager Configurations](https://training.snyk.io/courses/source-code-manager-configurations).
{% endhint %}

## What's next?

You can now [view Snyk scan results](https://docs.snyk.io/~/changes/TzxJRMARwBuZNPcIpizY/getting-started/quickstart/view-snyk-scan-results).