# Design Versions

*Skill Level: Beginner*

## Intro Video

{% embed url="<https://youtu.be/vPfhNBIlT0g>" %}

## Before You Begin

* Ensure you have an app to save as a design version!
* Design versions only save the visuals and layouts of your app. *They do not save database changes of any kind.*
* You will need a paid Adalo plan to use this feature.

## &#x20;Walkthrough

{% tabs %}
{% tab title="Simple" %}
**1.)** To create a design version, click on the Versions tab in the left menu <img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FKYu39Wf45IXzfwweTLa4%2FScreen%20Shot%202022-05-10%20at%204.51.48%20PM.png?alt=media&#x26;token=36e17587-c018-4cf5-bc64-4437294001db" alt="" data-size="line">, then click **+Create Design Version.**

&#x20;<img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2F6hbZM2J3nWHbDSkDWcU5%2FScreen%20Shot%202022-05-10%20at%204.52.49%20PM.png?alt=media&#x26;token=20c22f26-4d4c-44a7-b129-bd904dd7d25a" alt="" data-size="original">

**2.)** A popup will appear where you can give your version a name and optionally provide some notes about the version such as version number, changes made, questions that need answering, etc. When finished, click **Create**.

![](https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2Fj7SqasQMJdjl5gNlWXsC%2FScreen%20Shot%202022-05-10%20at%204.55.04%20PM.png?alt=media\&token=43448405-f951-4ab5-8141-579de24eac95)

**3.)** In the **Versions** tab, you can also see a list of your previous versions (up to 10). The list includes both manual saves as well as automatic saves of your app. You can see the name of the version, a preview of its notes, who created it, and when.<br>

**4.)**  Clicking on the More button on a version will reveal some options. You can click on **Version Details** to see the full name and all notes for a version. Clicking on **Restore Version** will revert the current working version of your app back to the selected saved version. Click on **Delete Version** to... well... delete the saved version.

![](https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FrSFwqKOoA7w7FjIkRliX%2FScreen%20Shot%202022-05-10%20at%205.00.41%20PM.png?alt=media\&token=4c757b1d-4960-4d0d-b3f3-f8c053d2f1c2)

**5.)** In case you're unsure about what is saved in a design version, we've created a handy chart below showing which items will change when you restore a design version.

{% hint style="info" %}
**IMPORTANT:** While the collections, properties, and record data are not saved in versions, the way they are connected to your app (through lists, forms, etc.) **are** saved in design versions.
{% endhint %}

| Item                                                                                                  | Will change upon version restore? |
| ----------------------------------------------------------------------------------------------------- | --------------------------------- |
| Screens and screens tab settings                                                                      | ✅                                 |
| Components on each screen                                                                             | ✅                                 |
| Setup of components on each screen (ex: list filter setup, which Collection is linked to a list, etc) | ✅                                 |
| Branding tab settings                                                                                 | ✅                                 |
| Screen Type (Home, etc)                                                                               | ✅                                 |
| Domains                                                                                               | ✅                                 |
| Collection data                                                                                       | 🚫                                |
| Collections and Collection Setup                                                                      | 🚫                                |
| Collection Permissions                                                                                | 🚫                                |
| API Keys                                                                                              | 🚫                                |
| External Collections                                                                                  | 🚫                                |
| Custom Actions                                                                                        | 🚫                                |
| Installed or purchased components                                                                     | 🚫                                |
| App settings tab                                                                                      | 🚫                                |
| Publish settings                                                                                      | 🚫                                |
| Profile settings                                                                                      | 🚫                                |
| Team & Billing                                                                                        | 🚫                                |
| App Builds                                                                                            | 🚫                                |
| {% endtab %}                                                                                          |                                   |
| {% endtabs %}                                                                                         |                                   |

## Learn More

* Restoring a saved version will cause an auto-save version to be created before the restore happens.
* Saving database changes is not currently supported, but is something we would like to do in the future.
* Deleting collections is permanent between versions. If you delete a collection and try to restore it with a design version, it will not be restored.
* Changing the connected collection of forms and lists between design versions will be reflected whenever you restore a version.
* Design versions are per team, not per user.
* Private and paid components will remain unchanged between versions (i.e. components purchased in one version will be available for use in all versions).
* Custom actions also remain unchanged between versions (i.e. a custom action created in one version will be available for use in all versions.)

## Help

If you need additional help with this article, you can always ask in our [community forum](https://forum.adalo.com/)! Be sure to paste the link to this article in your post as well!
