Create a CodeGrade assignment in Canvas
================================================

.. deprecation_note:: /for-teachers/creating-an-assignment/in-canvas

.. note::

    The guide below assumes CodeGrade has been successfully integrated into
    your Canvas environment as external LTI app.

Creating a new CodeGrade assignment from within Canvas will correctly
add this assignment to the corresponding course in CodeGrade, a new course will
automatically be created in CodeGrade if it does not yet exist in CodeGrade.
Follow the steps below to create a new CodeGrade assignment in Canvas:

1. Click the **"+ Assignment"** button in Canvas.

2. Under submission type, select **"External Tool"**.

3. Under **"Enter or find an External Tool URL"** click the **"Find"** button.

4. In the dialog, select **"CodeGrade"** and click **"select"**.

5. Add your Due date and other Canvas options and finally save your assignment.

6. Your assignment will automatically open in Canvas and the CodeGrade environment will be visible.

7. Press the **"New tab"** button in the CodeGrade sidebar to open your newly created assignment in the standalone CodeGrade environment.

.. note::

    Grades are automatically sent back to Canvas after setting the
    **assignment state** to (:fa:`check`) **Done** in CodeGrade. While the
    assignment is in the (:fa:`check`) **Done** state, all grades and changes to
    grades are immediately sent back to Canvas.

.. note::
    Students can hand in and review their feedback from within the CodeGrade
    container in Canvas.