Version tags

Version tags help you manage, share, and restore different app states in the App Builder. Think of them as snapshots of your app's core logic and UI.

What is a version tag?

A version tag is a configuration file representing a specific app state. It includes all backend logic (functions and flows), UI elements and widget configurations, and all existing links.

What's NOT included in a tag: Files, instances, database table data, theming, etc. are not stored within a tag.

How version tags are created

• Manually: Create tags whenever you want to save a specific app state.

• Automatically: Every app deployment creates a new tag, giving you a history of your deployed versions.

Why use version tags?

• Save App States: Create restore points for "undo" functionality or to experiment safely.

• Share Apps: Export a tag to share a specific app version with others, even across different accounts.

• Create Templates: Use a tag as a starting point or template for new apps.

Working with version tags

Video demo

Create a new tag

1. Click the Tag icon.

2. Enter a name for your tag.

3. Click Save.

Open tag from history

To load a previously saved or automatically generated app state:

1. Click the Tag icon.

2. Select a tag from the history list.

3. Confirm you want to load it.

Recommendation: Before loading an older tag, create a new tag of your current work. This lets you easily jump back if needed, as loading a tag overwrites your unsaved changes.

Export a tag

Exporting a tag allows you to create a portable file (.hwt) of your app's state, which can then be shared with others or imported into different app builder environments.

1. Click the Tag icon to open tag history.

2. Find the tag you want and click its Download icon.

3. A .hwt file will download to your computer

Import and apply a tag

Importing and applying a tag lets you load an app state from a .hwt file that was previously exported. This is great for sharing app configurations or restoring an app from a backup.

1. Click the Tag icon.

2. Click the Import button.

3. Choose the .hwt file from your computer.

4. In the dialog, click Switch to apply the imported tag.

Recommendation: Before importing, create a new tag of your current app state. This gives you a rollback point if the imported tag isn't what you expected.