From f32315fb28782d86cdcc5b8119d9ef03ca78d544 Mon Sep 17 00:00:00 2001
From: Eric Swanson <eric.swanson@dfinity.org>
Date: Mon, 22 Jan 2024 15:12:40 -0800
Subject: [PATCH] docs: add documentation for dfx identity import

Fixes https://dfinity.atlassian.net/browse/SDK-601
---
 docs/cli-reference/dfx-identity.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/cli-reference/dfx-identity.md b/docs/cli-reference/dfx-identity.md
index b993171ced..52185f3af4 100644
--- a/docs/cli-reference/dfx-identity.md
+++ b/docs/cli-reference/dfx-identity.md
@@ -22,6 +22,7 @@ For reference information and examples that illustrate using `dfx identity` comm
 | [`get-principal`](#dfx-identity-get-principal) | Shows the textual representation of the principal associated with the current identity.                                   |
 | [`get-wallet`](#dfx-identity-get-wallet)       | Shows the canister identifier for the wallet associated with your current identity principal.                             |
 | `help`                                          | Displays this usage message or the help of the given subcommand(s).                                                       |
+| [`export`](#dfx-identity-export)               | Exports the PEM definition for an identity. |
 | [`import`](#dfx-identity-import)               | Creates a new identity by importing a PEM file that contains the key information or security certificate for a principal. |
 | [`list`](#dfx-identity-list)                   | Lists existing identities.                                                                                                |
 | [`new`](#dfx-identity-new)                     | Creates a new identity.                                                                                                   |
@@ -110,6 +111,25 @@ To display the canister identifier for the wallet canister associated with your
 dfx identity get-wallet --network=https://192.168.74.4
 ```
 
+## dfx identity export
+
+Use the `dfx identity export` command to export the PEM definition of an existing identity.  You can import this definition elsewhere using [`dfx identity import`](#dfx-identity-import).
+
+### Basic usage
+
+``` bash
+dfx identity export identity-name
+```
+
+### Examples
+
+The following will export a PEM file for an existing identity.  If you transferred this file to another computer, the
+example below for `dfx identity import` would import it.
+
+``` bash
+dfx identity export alice >generated-id.pem
+```
+
 ## dfx identity import
 
 Use the `dfx identity import` command to create a user identity by importing the user’s key information or security certificate from a PEM file.