> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/mago-stage-client-apps/user-guide/cloud-drive-refresh-behavior.md).

# Cloud Drive refresh behavior

Mago Stage can use files stored in Google Drive, OneDrive, and SharePoint. Cloud files remain in the connected cloud service and are retrieved when required.

Cloud files are stored in Mago Stage as references. They are not copied into normal Stage storage and do not count against the user’s Mago Stage storage quota.

#### Cloud references and stored copies

Content selected directly from Google Drive, OneDrive, or SharePoint remains linked to its source and is stored in Mago Stage as a reference.

Content that a user uploads separately or explicitly copies into Mago Stage is stored independently. Changes to the original cloud file do not automatically update a separately uploaded or copied item.

Google-native documents are exported to PDF when Mago Stage requests them for display. The generated PDF can be cached temporarily to improve performance, but it is not permanently copied into normal Mago Stage storage.

If the connected account is disconnected or loses access to the source, linked cloud content may stop loading or refreshing. Separately uploaded or copied content remains available according to the organization’s storage and retention policies.

### Individual cloud files

Files selected individually continue to reference the original cloud files.

When the content is loaded again, Mago Stage retrieves the latest accessible version. You do not normally need to remove and re-add the item after updating the original file.

If the original file is deleted or the connected account loses access, the Stage item may no longer load.

### Synced cloud folders

A folder selected from Google Drive, OneDrive, or SharePoint creates a synchronized content group.

The group includes supported files stored directly inside the selected folder. Nested subfolders are not synchronized recursively.

When the folder is refreshed, Mago Stage checks for:

* Newly added files.
* Removed files.
* Renamed files.
* Files that are no longer supported or accessible.

{% hint style="info" %}
A synchronized folder group is managed from its source folder. Add, rename, or remove files in the cloud folder, then refresh the group in Mago Stage.
{% endhint %}

### Stages created from Drive

A Stage created using **Create from Drive** remains linked to the selected cloud folder.

These Stages cannot be edited directly in Mago Stage. Update the source folder and refresh the Stage instead.

Mago Stage checks the linked folder when the Stage opens. Use the manual refresh option when you need to check for changes immediately.

### Refresh cloud content

To refresh synchronized content:

1. Open the Stage.
2. Open the content drawer.
3. Locate the synchronized folder group.
4. Select its refresh action.
5. Wait for Mago Stage to check the connected cloud folder.

If no changes are found, Mago Stage reports that the folder is up to date.

| Change in the cloud folder    | Result after refresh                                              |
| ----------------------------- | ----------------------------------------------------------------- |
| A supported file is added     | The file is added to the synchronized content.                    |
| A file is removed             | The corresponding cloud item is removed.                          |
| A file is renamed             | The displayed name is updated.                                    |
| A file’s contents are updated | The latest accessible version is retrieved when the item reloads. |
| An unsupported file is added  | The file is ignored.                                              |
| A nested subfolder is added   | Its contents are not synchronized recursively.                    |

### If refresh fails

If Mago Stage cannot refresh the folder:

1. Confirm that the controller is online.
2. Open your profile and check the connected account.
3. Select **Reconnect** if access has expired.
4. Confirm that the linked account can still open the folder and its files.
5. Return to the Stage and try refreshing again.

For account permissions, external sharing, and tenant restrictions, see **Cloud tenant and sharing restrictions**.
