> For the complete documentation index, see [llms.txt](https://help.timelygrader.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.timelygrader.ai/moodle-support-articles/assignments/before-you-start-setting-up-timelygrader-in-your-moodle-course.md).

# Before You Start: Setting Up TimelyGrader in Your Moodle Course

Enrol the TimelyGrader Web Service, turn on the TimelyGrader LTI tool, and add TimelyGrader to your course before you launch it for the first time.

<figure><img src="https://3711328535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVTk0635Lo8R5owJx3bPK%2Fuploads%2F2fxvIUk6kO5NV6YbNqZ3%2Farticle-banner.png?alt=media" alt=""><figcaption></figcaption></figure>

Setting up TimelyGrader in Moodle takes a little more than adding an LTI tool. Each course needs three things in place before TimelyGrader can be launched:

1. The **TimelyGrader Web Service** is enrolled in the course with an instructor role.
2. The **TimelyGrader** LTI tool is turned on in the course.
3. **TimelyGrader** is added to the course as an activity or resource.

{% hint style="info" %}
Steps 1 and 2 can be done by the instructor or by a Moodle administrator. If you can’t find an option below, your role may not have permission to change it; ask your Moodle administrator.
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Enrol the TimelyGrader Web Service in the course

Open your course and go to **Participants**. Click **Enrol users**, search for **TimelyGrader Web Service**, and assign it your institution’s instructor role. Depending on how your Moodle is set up, this role may be called **Teacher**, **Instructor**, **Professor**, or something equivalent. Then click **Enrol users**.

{% hint style="warning" %}
The TimelyGrader Web Service needs an instructor-level role. With a student or non-editing role, TimelyGrader can’t work with your course.
{% endhint %}
{% endstep %}

{% step %}

### Turn on Edit mode

Switch on **Edit mode** in the top right corner of the course.

<figure><img src="https://3711328535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVTk0635Lo8R5owJx3bPK%2Fuploads%2Fa6dnOIzqJU4fmiyxRpPO%2Fmoodle-edit-mode.webp?alt=media" alt="The Edit mode toggle switched on in Moodle" width="188"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Make sure the TimelyGrader LTI tool is turned on

In the course navigation, open **More** and choose **LTI External tools**. Find **TimelyGrader** in the list and make sure the **Show in activity chooser** toggle is on.

<figure><img src="https://3711328535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVTk0635Lo8R5owJx3bPK%2Fuploads%2FLjWhu1sULfh7Tdv4m6UZ%2Fmoodle-lti-external-tools.webp?alt=media" alt="TimelyGrader in the LTI External tools list, with Show in activity chooser turned on"><figcaption></figcaption></figure>

{% hint style="info" %}
If TimelyGrader isn’t listed under LTI External tools, the tool hasn’t been installed for your Moodle site yet. Ask your Moodle administrator to set it up.
{% endhint %}
{% endstep %}

{% step %}

### Add TimelyGrader as an activity or resource

In the section where you want the link (usually the top, General section), click **Add an activity or resource** and choose **TimelyGrader**. Give it a name students will recognise, such as *Access TimelyGrader*, then click **Save and return to course**.

<figure><img src="https://3711328535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVTk0635Lo8R5owJx3bPK%2Fuploads%2FVwzmAfp7CqASmk6nwCsz%2Fmoodle-activity-chooser.webp?alt=media" alt="TimelyGrader in Moodle’s Add an activity or resource dialog"><figcaption></figcaption></figure>

See [Launching TimelyGrader from Your Moodle Course](https://help.timelygrader.ai/moodle-support-articles/assignments/launching-timelygrader.md) for the settings to use when adding the link.
{% endstep %}

{% step %}

### Launch TimelyGrader

Click the TimelyGrader link in your course. With all three steps done, TimelyGrader opens and you can start using it.
{% endstep %}
{% endstepper %}

{% hint style="success" %} <img src="https://3711328535-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVTk0635Lo8R5owJx3bPK%2Fuploads%2Fms2lmbcFJs7XOGunUDRn%2Fhugo-head.svg?alt=media" alt="Hugo" data-size="line"> **Hugo’s tip:** Do this setup once per course. After that, you and your students use the same TimelyGrader link every time.
{% endhint %}

## Troubleshooting

<details>

<summary>TimelyGrader doesn’t appear in Add an activity or resource.</summary>

The TimelyGrader LTI tool isn’t turned on for the course. Go to **More** → **LTI External tools** and switch on **Show in activity chooser** for TimelyGrader.

</details>

<details>

<summary>LTI External tools doesn’t list TimelyGrader.</summary>

The tool hasn’t been installed for your Moodle site. Ask your Moodle administrator to add it.

</details>

<details>

<summary>TimelyGrader opens, but my course isn’t working properly.</summary>

Check that the **TimelyGrader Web Service** is enrolled in the course under **Participants**, with an instructor-level role.

</details>

## Related articles

* [Launching TimelyGrader from Your Moodle Course](https://help.timelygrader.ai/moodle-support-articles/assignments/launching-timelygrader.md)
* [How to Sync Your Roster Manually](https://help.timelygrader.ai/moodle-support-articles/assignments/sync-roster.md)
* [Importing or Creating an Assignment](https://help.timelygrader.ai/moodle-support-articles/assignments/importing-or-creating-an-assignment.md)
