{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Import Addresses"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"import-addresses","__idx":0},"children":["Import Addresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Import a YAML file to add many addresses, and the groups they belong to, to your"," ","Address Book, in a single operation that requires a single Admin Quorum approval."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The file you import is normally one you"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/addresses/export-addresses"},"children":["exported"]}," from another Fordefi organization and edited"," ","outside Fordefi."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/organization-management"},"children":["admins"]}," can import addresses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An import requires a single ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/admin-quorum"},"children":["Admin Quorum"]}," approval, in the"," ","same way as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/addresses/bulk-address-motivation"},"children":["bulk-adding addresses"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"import-the-file-in-the-fordefi-web-console","__idx":1},"children":["Import the file in the Fordefi web console"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the Fordefi web console."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the side menu, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Address Book"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/import-addresses-menu.7e0d371e9b72ecddf4f7f64428e3dc39b817beb8df775f527035f8cddbb67330.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"700","border":"1px solid lightgray"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Address"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import addresses"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import addresses"]}," dialog opens."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/import-addresses-upload.558b330b0cfe99c4fde4def39f3c2bae1c0f7b20247b001b45244654c1951dd3.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"350","border":"1px solid lightgray"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Drag your address book YAML file onto the dialog, or click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Browse"]}," and select"," ","it. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Fordefi parses and validates the file, then displays the number of addresses it"," ","contains, followed by a card for each address showing its name, blockchain"," ","address, groups, and chains."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/import-addresses-review.f172e7b505908a98a67b455f3a9da57d6bd53e7f6590499131750ea63a682d50.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"350","border":"1px solid lightgray"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the file references groups that do not exist yet, the dialog reports how many"," ","new groups will be created. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review new groups"]}," to see their names, then"," ","click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Back"]}," to return to the address list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Groups are matched by name. Existing groups are reused, and any that do not"," ","exist yet are created when the import is approved."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the errors and warnings reported on the address cards, and resolve them as"," ","described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#errors"},"children":["Errors"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit for approval"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"An import address book request is sent to the Admin Quorum for verification."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":2},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fordefi validates every entry in the file before the import can be submitted."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Errors"]}," block the import. You cannot submit while any address still has an"," ","error. Fix the entry in the YAML file and upload the file again, or remove the"," ","entry."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warnings"]}," do not block the import. They tell you that an address in the file"," ","differs from one that already exists in your Address Book, so that you can decide"," ","whether to proceed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following errors can be reported:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invalid address:"]}," The address is not valid for the chain it is assigned to."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unsupported chain:"]}," The address is assigned to a chain that does not exist in"," ","this organization, such as a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/manage-chains/add-custom-chain"},"children":["custom chain"]}," ","that was never added here."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invalid asset:"]}," The address is assigned to an asset that Fordefi does not"," ","recognize on that chain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Duplicate contacts in file:"]}," The same address appears more than once in the"," ","file you uploaded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name already exists:"]}," An address in the file uses the name of a different"," ","address that already exists in your Address Book."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approve-the-import-in-the-admin-quorum","__idx":3},"children":["Approve the import in the Admin Quorum"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To complete the import, the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/admin-quorum"},"children":["Admin Quorum"]}," must do the"," ","following on their mobile devices."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inbox"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tap ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import address book request"]}," to view the addresses and groups in the"," ","import."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tap ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approve"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the required number of admins approve the request, the addresses are added to"," ","the Address Book and any new groups are created."]}]},"headings":[{"value":"Import Addresses","id":"import-addresses","depth":1},{"value":"Import the file in the Fordefi web console","id":"import-the-file-in-the-fordefi-web-console","depth":2},{"value":"Errors","id":"errors","depth":2},{"value":"Approve the import in the Admin Quorum","id":"approve-the-import-in-the-admin-quorum","depth":2}],"frontmatter":{"seo":{"title":"Import Addresses"}},"lastModified":"2026-09-17T10:51:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/addresses/import-addresses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}