Skip to content

Document Local Drive imports in the browser #1065

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
pierremtb wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Document Local Drive imports in the browser #1065

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c18c01b
Document the browser Local Drive file picker
pierremtb Sep 29, 2026
75b3b31
Describe automatic Local Drive picker opening
pierremtb Oct 1, 2026
d6b3634
Document browser imports into new projects
pierremtb Oct 1, 2026
8a47557
Require an open project for adding files
pierremtb Oct 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 21 additions & 14 deletions content/pages/docs/zoo-design-studio/features/data-management/import.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ model's KCL code so its geometry can appear in the Scene.

## Add File to Project

Choose one of the methods below to add files. In the browser, use **drag and drop** for files on your
computer. The **Local Drive** picker is available only in the desktop app.
Choose one of the methods below to add files from your computer or the sample library.
Drag and drop and the **Local Drive** picker are available in both the browser and desktop app.

### Drag and Drop (Browser and Desktop)

Expand All @@ -27,22 +27,29 @@ computer. The **Local Drive** picker is available only in the desktop app.
For ZIP archives, unzip them on your computer first, then drag the extracted files and folders into
**Project Files**. Keep the folder structure intact so relative file references continue to work.

### Local Drive Picker (Desktop Only)
### Local Drive Picker (Browser and Desktop)

1. Open the Command Bar.
2. Select **Add file to project**.
3. Choose **Local Drive** as the source.
4. Choose a new or existing project and enter or select its name.
5. Browse to the file location.
6. Select the file to add.
1. Open a project, or create and open a new project.
2. Open the Command Bar.
3. Select **Add file to project**.
4. Choose **Local Drive** as the source.
5. Select the destination project if prompted.
6. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed.
7. Submit the command.

The picker adds one file at a time. Use drag and drop to add multiple files or folders.
An added `.kcl` file opens in the Code Editor; other files appear in **Project Files**.

### KCL Samples (Browser and Desktop)

1. Open the Command Bar.
2. Select **Add file to project**.
3. Choose **KCL Samples** as the source if prompted. In the browser, this source is selected automatically.
4. Select a sample from the library.
5. Select the destination project. The desktop app also lets you create a new project from the sample.
1. Open a project, or create and open a new project.
2. Open the Command Bar.
3. Select **Add file to project**.
4. Choose **KCL Samples** as the source.
5. Select a sample from the library.
6. Select the destination project if prompted.

To create a new project from a sample, use **Create from a sample** on the Home page.

Once your files are in the project, continue below to import one into a model. To edit a `.kcl` file
as its own model, open it directly from **Project Files**.
Expand Down
Loading