Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Importing Elements

Introduction

Gum supports importing elements into your project, making it easier to reuse existing work. Elements can be imported from your project's folder structure, from a different project on disk, or from projects located on the internet.

Importing from projects requires Gum February 2026 or newer.

Importing Elements in Project Subfolder

Files which are already added to a subfolder of your project can be directly imported. To do this:

  1. Save a Screen or Component to your project's Screens or Components folder, or a contained subfolder

  2. Right click on your Screens or Components folder and select the Import item

  3. Select the component in the list, or click Browse... to locate a component

  4. Click the Import button

Importing from Project (.gumj/.gumx)

Gum supports importing one or more elements from an existing Gum project (.gumj or .gumx). When importing elements, Gum also imports:

  • Elements referenced by instances or through inheritance

  • Referenced behaviors

  • Referenced files, such as .png or .ganx (Gum Animation Xml)

This option is useful if you would like to import a set of components, such as a restyled set of Forms controls.

To import from a project:

  1. Click the Content -> Import -> .gumx... menu item (it opens both .gumj and .gumx projects)

  2. Select either Local File or URL depending on the location of the project file

  3. Browser or enter the location of the project

  4. Select the desired objects to import. You can click entire folders to select all contained objects. Note that dependencies (such as behaviors) are automatically checked.

  5. Click the Import button

Importing Standard Elements

An imported Standard element replaces the Standard of the same name in your project entirely, including its animations. Your project's own values, variables, categories, and animations on that Standard are gone after the import. The Skip Existing choice for elements that already exist applies only to components, screens, and behaviors, never to Standards.

When a selected component or screen uses a Standard that differs from yours, Gum always imports that Standard with it. Its check box is disabled, and hovering over it shows which elements use it.

Last updated

Was this helpful?