Agentic UI: Add backup import to the site overview by bcotrim · Pull Request #4500 · Automattic/studio

bcotrim · 2026-08-10T20:01:40Z

Related issues

Fixes to STU-2008

How AI was used in this PR

Claude Code wrote the implementation and tests. I reviewed the diff and verified the behaviour in the browser (both themes) before pushing.

Proposed Changes

Import was only reachable in the Agentic UI while creating a site, so there was no way to restore a backup over a site you already had — you had to start site creation over. Export already lived in the site overview; import now sits beside it.

Picking a backup asks for confirmation before overwriting, then reports progress, success, and failure. Import and export block each other while either is running, matching Classic.

Also brings site creation in line with Classic on .sql: a database dump has no files to go with it, so it can only be imported over an existing site, not used to create one. The Agentic onboarding card accepted .sql and nothing downstream rejected it, so it would create a site from bundled WordPress files and apply a dump whose themes and plugins were missing from disk.

Light	Dark	Confirmation

Testing Instructions

Open a site → Overview → Manage. Click Import, pick a backup, confirm the overwrite. Check the progress, then the result.
Pick an unsupported file (e.g. .txt) — it should be rejected before the confirmation appears.
While an export is running, Import should be disabled, and vice versa.
On Add a site → Import from a backup, a .sql file should now be rejected; a .zip/.tar.gz should still go through.
Check both light and dark.

Pre-merge Checklist

Have you checked for TypeScript, React or other console errors?

wpmobilebot · 2026-08-10T20:18:32Z

📊 Performance Test Results

Comparing 4ba390e vs trunk

app-size

Metric	trunk	`4ba390e`	Diff	Change
App Size (Mac)	1406.64 MB	1406.65 MB	+0.01 MB	⚪ 0.0%

site-editor

Metric	trunk	`4ba390e`	Diff	Change
load	1074 ms	1065 ms	9 ms	⚪ 0.0%

site-startup

Metric	trunk	`4ba390e`	Diff	Change
siteCreation	7528 ms	7545 ms	+17 ms	⚪ 0.0%
siteStartup	2879 ms	2883 ms	+4 ms	⚪ 0.0%

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change (<50ms diff)

katinthehatsite

I see that: apps/ui/src/data/queries/use-import-site.ts file has the following comment:

/**

Runs a backup import against a site that has just been created. The
The cached site list is invalidated so metadata changed by the importer is
picked up.
*/

We should probably adjust it since we are now using the hook not only for the newly created site.

katinthehatsite · 2026-08-11T08:21:41Z

Generally, it works well but I noticed that i can duplicate a site while it is importing, should we disable the duplication in that case?

bcotrim · 2026-08-11T09:24:08Z

Generally, it works well but I noticed that i can duplicate a site while it is importing, should we disable the duplication in that case?

Yes, I think we should disable it
I am working around blocking operations in #4406 so I will confirm this use case there

…entic-ui' into stu-2008-add-import-export-to-agentic-ui

katinthehatsite · 2026-08-12T07:31:27Z

I am working around blocking operations in #4406 so I will confirm this use case there

Sounds good 👍

katinthehatsite

The import itself worked well for me but I noticed that I am having a hard time reaching the Overview tab of another site while the import is in progress. I tried to capture it in the screencast below:

Screen.Recording.2026-08-12.at.9.33.04.AM.mov

Do you see something similar?

katinthehatsite · 2026-08-12T07:36:14Z

+				description={ __(
+					'Importing a backup will replace the existing files and database for your site.'
+				) }
+				confirmButtonText={ __( 'Import' ) }


I am not sure whether this button needs to have destructive styling:

It seems a bit intense there, what do you think? Although can be left as is if that's the intention

bcotrim · 2026-08-12T17:21:26Z

Thanks for the review @katinthehatsite!

Both of your findings are fixed:

Sluggish navigation mid-import
The Import confirm is no longer red

Also changed while in here:

Progress moved out of the toast into the per-site activity row (sidebar + site dropdown), so simultaneous imports stay told apart by site.
Progress labels now lead with a zero-padded percentage (03% · Creating remote backup…) so they don't shift as they tick. This also changes the CLI sync strings.
The overview refetches WP version, disk usage and the screenshot after an import.

Can you take another look, please? 🙇

katinthehatsite · 2026-08-13T08:25:57Z

 } ) );

 vi.mock( '@/data/queries/use-sites', () => ( {
+	// The real `useImportSite` invalidates this key on success.


I think we can drop this comment, it seems self-explanatory

katinthehatsite · 2026-08-13T08:26:34Z

 	useOffline: vi.fn(),
 } ) );

+// Real store elsewhere — the pending/success entries drive the button states


Can also be cleaned up as the pattern is evident from the code

katinthehatsite · 2026-08-13T08:29:46Z

+		);
+		await waitFor( () => expect( emitProgress ).toBeDefined() );
+
+		// 500 chunks spanning two whole-percent steps of the same 10-file backup.


It seems that this just descibes what the loop does so I would drop it as well

katinthehatsite

The functionality worked well and switching between the sites while import is in progress also looked good 👍

Also, thanks for adjusting this Import button:

I left a couple of comments regarding cleaning up the redundant comments but these are non-blocking

…export-to-agentic-ui # Conflicts: # apps/ui/src/components/site-dropdown/main-view.tsx # apps/ui/src/components/site-overview-view/index.test.tsx # apps/ui/src/hooks/use-site-management-actions.ts

bcotrim added 2 commits August 10, 2026 21:01

Add backup import to the Agentic UI site overview

be62a33

Exclude .sql dumps from Agentic UI site creation

c4ca566

github-actions Bot assigned bcotrim Aug 10, 2026

bcotrim requested review from katinthehatsite, nightnei, sejas and shaunandrews August 10, 2026 20:05

katinthehatsite reviewed Aug 11, 2026

View reviewed changes

bcotrim and others added 4 commits August 11, 2026 10:29

Merge branch 'trunk' into stu-2008-add-import-export-to-agentic-ui

01c1766

Correct import comments that assumed a freshly created site

9050b9d

Merge remote-tracking branch 'origin/stu-2008-add-import-export-to-ag…

e0efb72

…entic-ui' into stu-2008-add-import-export-to-agentic-ui

Use AlertDialog for the import overwrite confirmation

d0abc31

bcotrim requested a review from katinthehatsite August 11, 2026 10:52

katinthehatsite reviewed Aug 12, 2026

View reviewed changes

bcotrim added 9 commits August 12, 2026 12:14

Throttle import progress toasts and soften the overwrite confirm button

9d27c4b

Track import progress per site so it doesn't follow navigation

b1a5fed

Shorten import status messages so the toast stays on one line

221b5b1

Clamp the import progress toast to one line for longer translations

c08c2c7

Pad the import percentage to two digits instead of clamping the toast

ef6b27b

Use tabular figures in toasts so the import percentage doesn't shift

5004ebb

Show import progress per site instead of in a global toast

eb95315

Lead sync and import progress labels with a padded percentage

2c2fb67

Refetch site details invalidated by an import

a92fa5c

bcotrim requested a review from katinthehatsite August 12, 2026 17:21

katinthehatsite reviewed Aug 13, 2026

View reviewed changes

katinthehatsite approved these changes Aug 13, 2026

View reviewed changes

bcotrim added 2 commits August 13, 2026 09:35

Merge remote-tracking branch 'origin/trunk' into stu-2008-add-import-…

52f2d56

…export-to-agentic-ui # Conflicts: # apps/ui/src/components/site-dropdown/main-view.tsx # apps/ui/src/components/site-overview-view/index.test.tsx # apps/ui/src/hooks/use-site-management-actions.ts

Drop redundant comments from the site overview tests

4ba390e

bcotrim enabled auto-merge (squash) August 13, 2026 09:13

bcotrim merged commit 6f39f92 into trunk Aug 13, 2026
14 checks passed

bcotrim deleted the stu-2008-add-import-export-to-agentic-ui branch August 13, 2026 09:46

Navigation Menu

Uh oh!

Agentic UI: Add backup import to the site overview - #4500

Agentic UI: Add backup import to the site overview#4500
bcotrim merged 17 commits into
trunkfrom
stu-2008-add-import-export-to-agentic-ui

bcotrim commented Aug 10, 2026 •

edited

Loading

Uh oh!

wpmobilebot commented Aug 10, 2026 •

edited

Loading

Uh oh!

katinthehatsite left a comment

Uh oh!

katinthehatsite commented Aug 11, 2026

Uh oh!

bcotrim commented Aug 11, 2026

Uh oh!

katinthehatsite commented Aug 12, 2026

Uh oh!

katinthehatsite left a comment

Uh oh!

katinthehatsite Aug 12, 2026

Uh oh!

bcotrim commented Aug 12, 2026

Uh oh!

katinthehatsite Aug 13, 2026

Uh oh!

katinthehatsite Aug 13, 2026

Uh oh!

katinthehatsite Aug 13, 2026

Uh oh!

katinthehatsite left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

bcotrim commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related issues

How AI was used in this PR

Proposed Changes

Testing Instructions

Pre-merge Checklist

Uh oh!

wpmobilebot commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📊 Performance Test Results

app-size

site-editor

site-startup

Uh oh!

katinthehatsite left a comment

Choose a reason for hiding this comment

Uh oh!

katinthehatsite commented Aug 11, 2026

Uh oh!

bcotrim commented Aug 11, 2026

Uh oh!

katinthehatsite commented Aug 12, 2026

Uh oh!

katinthehatsite left a comment

Choose a reason for hiding this comment

Uh oh!

katinthehatsite Aug 12, 2026

Choose a reason for hiding this comment

Uh oh!

bcotrim commented Aug 12, 2026

Uh oh!

katinthehatsite Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

katinthehatsite Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

katinthehatsite Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

katinthehatsite left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

bcotrim commented Aug 10, 2026 •

edited

Loading

wpmobilebot commented Aug 10, 2026 •

edited

Loading