About saving options in Harmony Essentials

Updated on



Harmony has the following options for saving files depending on your workflow:

  • Scene file (.xstage)
  • Compact file (.vbd)(Version 25 and up only)

If you would like to read more about saving versions, please see Saving Scenes as New Versions.

The Harmony Scene file (.xstage)

This format is used for all Harmony scenes.

An .xstage file is a format saved in a folder that contains all the images, elements, sounds, palettes, etc. that are used in the scene. The .xstage file itself is represented by a Harmony page icon, and when this file is opened it will reference all of the files in the folder to load the saved scene. 

Open this file by double clicking the .xstage icon in the folder, or by using the Open options in the Welcome Screen or top menu.

For more information, see About the File Structure.

Moving Files

If you need to move an .xstage file, you must move the entire folder containing the files and the .xstage, as it needs to reference all these files when opening. Moving the .xstage file on its own will result in a blank scene when opened elsewhere.

A Harmony scene folder can be compressed into a single file by using a file archiver application. 

How to save it

An .xstage file is automatically created when you click on Create Scene on the Welcome Screen, or by choosing File > New Scene.

You can also save changes by using File > Save, or save copies of scenes by using the Save As option under File > Save As.

Welcome Screen File menu

The Compact file (.vbd)

The Compact file is a format that is part of a scene’s structure.

When using the Compact option with your Harmony scene, compatible elements will be combined into a single .vdb (virtual database) file inside the scene’s structure.

The below images show the difference between a regular .xstage file structure and one saved with the compact option.

Regular Structure Compact Structure


System/Network Strain and Speed:

A compacted structure contains fewer files and will improve the overall performance and efficiency when using the scene. Having specific files in one place helps with the efficient location of the content by the software, and will make the scene easier to access, transfer and share.

How to save it

You can turn your file structure into a Compact one by ticking the Compact File Structure box on the Welcome Screen when creating a new scene, or by going to Scene > Scene Settings > Advanced tab and choosing Compact.

Welcome Screen Scene Settings

Alternatively, if you want to uncompact the scene, go to Scene > Scene Settings > Advanced tab and choose Uncompact.

WARNING: Compact file structures are not compatible with software versions older than version 25. Make sure to uncompact any files before using them with older versions.

Was this article helpful?

0 out of 0 found this helpful

Can't find what you are looking for?

Contact Us

Submit a request and we will get back to you as soon as possible.

Open a Support Ticket

Ask Our Discord Community

Get answers from our worldwide community of artists and animators.

Join Our Discord Server

Join the Conversations

Connect with us on social media for inspiration, updates, feedback and more.