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

# Project Archive & Restore

> Archive a project without deleting it; restore from the list in one click, or with a .superun credential from manual archiving. Archive restore consumes Compute Credits: **follow the dialog; 29 Compute Credits is typical**; exact amount and balance requirements follow the in-app UI.

**Project Archive & Restore** lets you put projects you don't need to keep running into an **Archived** state—**without deleting their data**. Source code, version history, design, and configuration are preserved; only runtime resources (preview / live URLs, hosting envs) are reclaimed so the project no longer accrues ongoing runtime costs. **How you restore depends on how the project was archived:** if the project **still appears as archived** in **My Works** (or **My Projects**), use the **Restore** action on the card; if it was **manually archived** and removed from the main list, you need the **`.superun` credential file** and the **Restore archived project** entry to upload it.

## What it is

Archive is a **project lifecycle state** that sits between **Active** and **Permanently deleted**:

* **Data is preserved**: source, history, design, and configuration stay in your account—**nothing is dropped**.
* **Runtime resources are reclaimed**: published preview / live links and bound runtime environments **go offline**, no longer consuming continuously billed runtime resources.
* **Restorable**: you can restore an archived project at any time, returning it to active use.

Typical use cases:

* Projects you don't plan to iterate on short term but **may bring back online** later.
* Temporary pause when balance is insufficient (active or passive), with restore once you top up.

## Project states

| State                     | Meaning                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------- |
| **Active (not archived)** | Normal running state—edit, publish, and access freely                                               |
| **Archived**              | Data preserved, runtime resources reclaimed; shown in archived style in lists                       |
| **Restoring**             | You triggered restore; the system is re-allocating runtime resources, with progress shown as needed |

<Note>Exact state labels and styles follow the current product version.</Note>

## What triggers archiving

* **Auto-archive on insufficient balance**: if the account / project balance is consistently insufficient to cover ongoing runtime costs, the system moves the affected projects into **Archived** to prevent over-charging.

## Manual archive (.superun credential)

**Manual archive** is initiated by the project owner: the project no longer appears in the main **My Works** list, share links stop working, and **creation storage fee** (and related) billing pauses; data remains on the server. Later, you restore with a **`.superun` file** via **Restore archived project**.

Use it when you want to pause **creation storage–related** charges but may bring the project back later.

### Who can use it

* The project **owner** (creator / org space admin). Collaborators and regular members do not see the archive entry.

### Preconditions

| Requirement                         | Notes                                                                                               |
| ----------------------------------- | --------------------------------------------------------------------------------------------------- |
| Project is **not publicly live**    | Publicly published projects cannot be archived directly; **take them offline** in the product first |
| You are the project **owner**       | Non-owners cannot start a manual archive                                                            |
| Project is **not already mid-flow** | If already archiving or in a restore queue, follow the in-product prompts                           |

If requirements are not met, **Archive** may be hidden, or the server will reject the action with an error.

### Archive steps

**1. Open the archive entry**

1. Open the superun home or workspace and go to **My Works** (or the equivalent work list).
2. On the project card, open the **"…"** menu at the **bottom-right**.
3. Choose **Archive**.

<img src="https://b.ux-cdn.com/uxarts/files/t20260514103440/l8uvvvf5.png" alt="Choose Archive from the project card menu in My Works" width={700} style={{ borderRadius: '8px' }} />

**2. Download the `.superun` credential file**

1. After you confirm in the product flow, the browser prompts you to **save** a **`.superun`** file named after the project (for example `accounting-app.superun`).
2. **Keep this file safe**—it is the credential to restore this project. Save it locally and back it up (e.g. cloud storage).

<Note>If the `.superun` file was not saved successfully, do not complete the re-upload confirmation step; losing the file may block self-serve restore—contact support or operations.</Note>

<img src="https://b.ux-cdn.com/uxarts/files/t20260514103441/f289kjls.jpeg" alt="Browser save dialog for .superun during archive confirmation" width={700} style={{ borderRadius: '8px' }} />

**3. Re-upload `.superun` to confirm**

To avoid "archive applied but credential not saved", a **second confirmation** is required:

1. In the **Archive project** (or equivalent) dialog, **upload the same `.superun` file** you just downloaded, as prompted.
2. After validation, the system completes the archive.

**4. After archiving**

* The project leaves the main list or moves to an archived view (depends on version).
* Shared links (published site, build/share links, invites, etc.) show **link invalid** or equivalent.
* **Creation storage fee** billing **pauses** from the next cycle; whether **fees already charged this cycle** are refunded follows in-product billing rules.

<Note>Exact link copy, list placement, and billing details follow the current product version.</Note>

### Restore with **Restore archived project** and `.superun`

When the project was manually archived and no longer appears in the normal list, find **Restore archived project** on **My Works** (exact placement may vary with filters or empty states; it may also sit near an archived group).

<img src="https://b.ux-cdn.com/uxarts/files/t20260514103440/fgef6hxg.jpeg" alt="Restore archived project link on the works page" width={700} style={{ borderRadius: '8px' }} />

1. Click **Restore archived project** to open the dialog.
2. **Drag in or click to upload** your `.superun` file; the system checks format and that the project belongs to the signed-in user.
3. The dialog shows how many **Compute Credits** this restore will cost (**follow the dialog; 29 Compute Credits is typical**). Confirm your balance is sufficient, then click **Restore archived project** to submit.
4. Restore runs **asynchronously in the background**, usually within **24 hours** (often faster). You receive an **in-app message** when it completes; the project becomes editable again and **creation storage fee and related billing resume per product rules**.

<img src="https://b.ux-cdn.com/uxarts/files/t20260514103440/13rhnnlb.jpeg" alt="Upload .superun and confirm restore archived project" width={700} style={{ borderRadius: '8px' }} />

<Note>After restore, public sharing usually **does not** flip back to published automatically; publish again if you need live links. Avoid duplicate submissions while a job is queued; follow any extra hints shown in the current product version.</Note>

### Manual archive FAQ

* **I lost my `.superun` file.** Self-serve restore is not available; contact support or operations.
* **Is restore always 29 Compute Credits?** Not necessarily. **Follow the dialog; 29 Compute Credits is typical**; if project size or other factors change the amount, follow the restore dialog and in-app notices.
* **Can manual archive refund this month's fee?** No; whether anything is refunded follows product rules.

## Restore from the list (archived card)

If the project **still appears as archived** in **My Works** (or **My Projects**), open **Restore** (or equivalent) on the card—**no `.superun` file** needed. The confirmation dialog clearly shows:

* **Compute Credits required for this restore** (**follow the dialog; 29 Compute Credits is typical**).
* **Your current balance** and **whether it is sufficient**.
* **Scope and impact**, for example that runtime resources will be re-allocated.

After you confirm, the project enters **Restoring** and returns to **Active** when finished.

<Note>After cloud services are restored, database connection addresses may change. If you find that your project cannot access data properly after restoration, you can tell the AI to "redeploy" in the chat, or click "Repair" directly — the system will automatically complete the redeployment.</Note>

### Billing notes

* **Archive restore** (in-list restore and **Restore archived project** with `.superun`) **consumes Compute Credits**; **follow the dialog; 29 Compute Credits is typical**—do not rely on memory.
* After restore, **routine cloud and storage billing** for the project still follows product rules.

<Note>Whether other flows such as **Unarchive** incur fees follows the application page and in-product text.</Note>

## Archived projects can request to be unarchived

When a project is already archived and you don't actually want to bring it back online—but you do want it **out of the archived list and back in the normal list**—you can **request to unarchive**:

* Look for **Unarchive** in the action menu of an archived project (exact entry follows the current version).
* Unarchive is a **different action** from list restore: it focuses on **list visibility and state classification**. Whether runtime resources are spun back up or any cost is incurred follows the application page and in-product prompts.

<Note>Whether Unarchive is self-serve or requires a customer-support review, and any handling time, follow the in-product description.</Note>

## Cancel archive (avoid accidental archive)

To avoid an **accidental archive**, the system may provide a **cancellation window** right after archiving completes—within that window, you can **undo the just-applied archive** and the project returns to active.

<Note>The exact length of the cancellation window, its entry point, and whether it is fully free, follow the current product version.</Note>

## Permissions

* Project owners typically have archive and restore permissions.
* Collaborators / team members' visibility and actions depend on their role.

<Note>Exact per-role boundaries follow the product permission matrix.</Note>

## FAQ

* **Will I lose my code or data after archiving?** No—**project data is preserved**; only runtime resources are reclaimed.
* **Can I view version history while archived?** <Note>Whether history is viewable while archived, or whether restore is required first, follows the current product version.</Note>
* **How long does restore take?** List restore: <Note>Depends on size and scheduling; follow the **Restoring** state.</Note> `.superun` restore after manual archive: background job typically within **24 hours**; you get an **in-app message** when it completes—follow the dialog and status UI.
* **What happens to my tokens if restore fails?** <Note>Failure handling follows the in-product prompt; reach out to customer support if needed.</Note>
* **Can I restore multiple projects in bulk?** <Note>Whether bulk restore is supported follows the current product version.</Note>

***

<Card title="superun website" icon="globe" href="https://superun.com/web" horizontal>
  Visit the official website to see the full project management capabilities.
</Card>
