> ## Documentation Index
> Fetch the complete documentation index at: https://help.studystash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Moodle rollout: opt-out

> Add StudyStash to all eligible courses except those you explicitly exclude.

Compare the [rollout approaches](https://help.studystash.com/integrations/moodle-course-sync) before choosing a plugin.

## Before you begin

* Moodle 4.0+ (version `>= 2022041900`).
* Administrator access with `moodle/site:config` permission.
* A [preconfigured StudyStash LTI tool](https://help.studystash.com/integrations/moodle.md).
* Cron running in Moodle.
* The plugin ZIP from your Customer Success Manager.

## 1. Install the plugin

Open `https://<your-moodle-instance>/admin/tool/installaddon/index.php`.

Select **Choose a file…** and upload the ZIP from your Customer Success Manager. Select **Show more…** and set **Plugin type** to **Local plugin (local)**.

![Upload the plugin ZIP and select Local plugin.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/94076930-plugin-installer.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=ab34f1c39f399bc4f1d58262eac4b6f3)

Upload the plugin ZIP and select Local plugin.

Select **Install plugin from the ZIP file**. Select **Continue** after validation, then **Continue** after the server checks.

At the plugins check, select **Upgrade Moodle database now**.

![Complete the plugin installation with the Moodle database upgrade.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/93847574-plugins-requiring-attention.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=ebadfc89bd1eee13a9f94a7033535064)

Complete the plugin installation with the Moodle database upgrade.

If an **Upgrading to new version** message appears, select **Continue**.

## 2. Configure the plugin

Use these settings:

| Setting | Value | Required? |
| - | - | - |
| LTI preconfigured tool type ID | Select the correct StudyStash LTI Activity Module | Yes |
| StudyStash activity name | StudyStash | No |
| Placement in General section | Bottom | No |

![Select the StudyStash tool and choose the activity settings.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/94076937-new-settings.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=b883baaf648cfe582ee07d3102a989ee)

Select the StudyStash tool and choose the activity settings.

Select **Save changes**, then open `https://<your-moodle-instance>/local/studystash/index.php`.

![Open the rollout plugin to manage courses and sync tasks.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/93978670-image-20260217-235240.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=12018c443f6e04ae5d244cf534a5f557)

Open the rollout plugin to manage courses and sync tasks.

## 3. Choose courses to exclude

Open **Excluded Courses**. Use the filters to find any courses that should not receive the StudyStash activity, then select their checkboxes.

![Select courses to leave out of the rollout.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/93847605-image-20260217-235339.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=4bb6c7e3f36bff294366a75026c7a613)

Select courses to leave out of the rollout.

Select **Save excluded courses**, then return to **Status**.

## 4. Preview the sync

On **Status**, select **Dry Run** and wait for the task to finish. Larger course lists may take longer.

![Run a preview before changing course activities.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/93847611-image-20260217-235418.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=e58911b6e9d4a718b9ea3e19f746988c)

Run a preview before changing course activities.

Open **Logs** and check the planned behaviour for each course before continuing.

## 5. Sync the courses

When the preview is correct, return to **Status** and select **Sync StudyStash to Courses** to apply the changes.

![Run the sync after checking the dry-run logs.](https://mintcdn.com/studystash-help/UbXlxW0z5agaJ_Cy/assets/93847554/93978676-image-20260218-000003.png?fit=max\&auto=format\&n=UbXlxW0z5agaJ_Cy\&q=85\&s=c0db00be2abf42afd5cbc2775d627f06)

Run the sync after checking the dry-run logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.