diff --git a/operations/import-export.mdx b/operations/import-export.mdx
index 9403bc2..023a384 100644
--- a/operations/import-export.mdx
+++ b/operations/import-export.mdx
@@ -47,6 +47,15 @@ For convenience, you can supply `--create-namespace` in order for Flipt to autom
 flipt import --namespace production --create-namespace flipt.yaml
 ```
 
+<Note>
+  In [v1.28.0](https://github.com/flipt-io/flipt/releases/tag/v1.28.0), we introduced some breaking changes to `import`.
+
+You no longer have to use the `--namespace` or `--create-namespace` flags to import resources into a specific namespace.
+
+The namespaces are now inferred from the YAML documents themselves. If a namespace your document refers to does not exist in the database, it will be created.
+
+</Note>
+
 This command supports the `--drop` flag that will drop all data in your
 Flipt database tables before importing. This is to ensure that no data
 collisions occur during the import.
@@ -76,7 +85,6 @@ flags:
     name: Blue
   - key: green
     name: Green
-
 ```
 
 You can also export to a file using the `-o filename` or `--output filename`
@@ -92,3 +100,14 @@ Use the flag `--namespace` to export from a different namespace.
 ```yaml
 flipt export --namespace production
 ```
+
+<Note>
+  In [v1.28.0](https://github.com/flipt-io/flipt/releases/tag/v1.28.0), we have extended this functionality to support exporting state from multiple namespaces to a single YAML file.
+
+The `--namespace` flag is now deprecated.
+
+The `--namespaces` flag will accept a comma-delimited list of namespaces from which you would like to export from.
+
+The `--all-namespaces flag is a boolean flag that tells export to export all namespaces to the single file you specify, or to standard out by default.
+
+</Note>