# How do I import outcomes for a course?

You can bulk import outcomes for your course using a CSV file. A bulk import allows you to add new outcomes to your course or update the details of multiple outcomes at one time.

The CSV file must be formatted correctly according to the [Outcomes Import Format Documentation](https://canvas.instructure.com/doc/api/file.outcomes_csv.html). [Download a sample outcomes.csv file](https://s3.amazonaws.com/tr-learncanvas/files/outcomes/outcomes.csv) with one outcome group and six outcomes.

After your CSV file has been processed, you will receive an email notification confirming a successful import or displaying errors with your file. If there were errors, the email will contain details about the first 100 errors including the row of the error and a short description.

This lesson displays how to import outcomes in the classic Outcomes page view. If the Outcomes page in your course displays differently than the images in this lesson, learn how to [import outcomes in a course](https://community.canvaslms.com/t5/Instructor-Guide/How-do-I-import-outcomes-into-a-course-in-Improved-Outcomes/ta-p/486359) within an account that has enabled the Improved Outcomes Management feature option.

**Notes:**

<div id="bkmrk-currently%2C-only-csv-"><div>- Currently, only CSV files are supported. JSON files will be supported in a future release.
- Importing outcomes is a course permission. If you do not have permission to import outcomes, your institution has restricted this feature.
- In new outcomes, the vendor\_guid field must not contain a colon.

</div></div>## Open Outcomes

<div data-step-uuid="c6c7b00d-7b7b-45aa-ad73-cbc847ddb8f3" id="bkmrk-"><div data-step-uuid="c6c7b00d-7b7b-45aa-ad73-cbc847ddb8f3"><div>![Open Outcomes](https://media.screensteps.com/image_assets/assets/002/779/628/original/22ea7306-c158-466a-94fb-2eab17bff64b.png)</div><div><div></div></div></div></div>In Course Navigation, click the **Outcomes** link.

## Import Outcomes

<div data-step-uuid="bfee4102-e9e7-42c2-a513-0b5eef3aa919" id="bkmrk--0"><div data-step-uuid="bfee4102-e9e7-42c2-a513-0b5eef3aa919"><div>![Import Outcomes](https://media.screensteps.com/image_assets/assets/003/378/380/original/93b04751-7233-44c2-824a-9e580219b359.png)</div><div><div></div></div></div></div>Click the **Import** button.

## Upload File

<div data-step-uuid="a80b59a3-914e-4bdd-a1cc-351ca3fa67c1" id="bkmrk--1"><div data-step-uuid="a80b59a3-914e-4bdd-a1cc-351ca3fa67c1"><div>[![Upload File](https://media.screensteps.com/image_assets/assets/001/450/174/medium/f509e667-ef59-417e-a257-f49fb4ddaaa5.png)](https://media.screensteps.com/image_assets/assets/001/450/174/original/f509e667-ef59-417e-a257-f49fb4ddaaa5.png)</div><div><div></div></div></div></div>Drag and drop your CSV file to the upload area, or click in the upload area to choose a file from your computer.

## Open File

<div data-step-uuid="f6c429d3-a487-4a48-9e9a-032445ca1ac8" id="bkmrk--2"><div data-step-uuid="f6c429d3-a487-4a48-9e9a-032445ca1ac8"><div>![Open File](https://media.screensteps.com/image_assets/assets/001/450/168/original/4c46184c-b05f-49df-ad0c-b2be880ed19c.png)</div><div><div></div></div></div></div>Locate the CSV file \[1\] and then click the **Open** button \[2\].

## View Import Status

<div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba" id="bkmrk--3"><div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba"><div>[![View Import Status](https://media.screensteps.com/image_assets/assets/003/384/542/medium/d4641ada-c6c5-4af9-8869-218b91623bea.png)](https://media.screensteps.com/image_assets/assets/003/384/542/original/d4641ada-c6c5-4af9-8869-218b91623bea.png)</div><div><div></div></div></div></div>Canvas displays a loading page while the file uploads. Large CSV files may take time to import. You can leave the Outcomes page at any time without disrupting the import process.

### View Import Success

<div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba" id="bkmrk--4"><div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba"><div data-step-uuid="90deba84-f84d-45b5-9cee-3311be4b9b4f"><div>![View Import Success](https://media.screensteps.com/image_assets/assets/003/384/544/original/59f93041-c199-4f60-8929-c85459077500.png)</div><div><div></div></div></div></div></div>When the file has been successfully imported, Canvas displays a confirmation message. You will also receive an email that the import was successful.

### View Import Errors and Warnings

<div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba" id="bkmrk--5"><div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba"><div data-step-uuid="9bef95e3-de76-4838-b6ff-5795bae9895c"><div>![Import Error](https://media.screensteps.com/image_assets/assets/003/384/541/original/49094a28-5130-4658-b6bd-c2c295d3f048.png)</div><div><div></div></div></div></div></div>If the import was not successful, or if the import altered existing outcomes, Canvas displays an error message.

The error message displays for outcome import errors and for outcome import warnings.

You will receive an email with details about the first 100 errors and warnings. Each error or warning will include the CSV row number and a description of the error or warning.

Import errors stop the import process entirely and need to be fixed before outcomes can be imported successfully. The following types of errors may occur in CSV files:

<div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba" id="bkmrk-required-headings-ar"><div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba"><div data-step-uuid="9bef95e3-de76-4838-b6ff-5795bae9895c"><div><div>- Required headings are missing
- Other headings are placed after the ratings header
- Invalid headers are present
- Required fields are missing
- Import file contains no data
- Invalid UTF-8 string

</div></div></div></div></div>When an import warning occurs, Canvas skips the affected row and the import moves on. The following types of warnings may occur in CSV files:

<div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba" id="bkmrk-rating-tiers-have-mi"><div data-step-uuid="50489b88-d4d2-4e33-8eec-1bd2fb9bd2ba"><div data-step-uuid="9bef95e3-de76-4838-b6ff-5795bae9895c"><div><div>- Rating tiers have missing points
- Rating tiers have invalid point values
- Rating tiers have points in wrong order
- Object type is incorrect
- Parent group refers to missing outcomes
- Parent groups are invalid
- Workflow state is invalid
- Calculation validation method not specified
- Group receives invalid fields
- Outcome edits are not within the same context

</div></div></div></div></div>Correct the errors in the CSV file according to the [Outcomes Import Format Documentation](https://canvas.instructure.com/doc/api/file.outcomes_csv.html) and re-import the file.

## View Outcomes

<div data-step-uuid="cb9bae2a-2b6a-47dd-af9a-0da186111af2" id="bkmrk--6"><div data-step-uuid="cb9bae2a-2b6a-47dd-af9a-0da186111af2"><div>[![View Outcomes](https://media.screensteps.com/image_assets/assets/003/384/545/medium/f28d6caf-1d5e-4c6a-921f-fc84485ffd85.png)](https://media.screensteps.com/image_assets/assets/003/384/545/original/f28d6caf-1d5e-4c6a-921f-fc84485ffd85.png)</div><div><div></div></div></div></div>View the outcomes imported into your course.

\[Content retrieved from [https://community.canvaslms.com/t5/Instructor-Guide/How-do-I-import-outcomes-for-a-course/ta-p/702](https://community.canvaslms.com/t5/Instructor-Guide/How-do-I-import-outcomes-for-a-course/ta-p/702)\]