--- title: Importing data exported from Safari framework: safariservices role: article role_heading: Article path: safariservices/importing-data-exported-from-safari --- # Importing data exported from Safari Transfer bookmarks, saved passwords, and other information between browsers. ## Overview Overview In iOS, iPadOS, and visionOS, people can export their browser data to a file from Safari’s settings in Settings. In macOS, the person exports Safari’s browser data by choosing File > Export from Safari. In either case, the system presents the Export Browsing Data sheet, which walks the person through the export process. Alternatively, you can present the export sheet from a browser app that you develop by calling the SFSafariSettings class’s openExportBrowsingDataSettings(completionHandler:) method. Safari exports the data in a ZIP archive that contains a bookmarks file, a passwords file, and a payment cards file. For each Safari profile, the ZIP archive also includes a browser history file and a Safari extensions file. The files have localized file names; in the en_US locale, their names are: When someone creates multiple profiles, Safari exports the browser history and extension information for each profile into a separate file with the profile name as a filename suffix. To import this data, create UI in your browser that someone uses to share the ZIP archive they export from Safari. Unzip the file, and use the information in the sections below to interpret the contents that you load into your browser’s data model. Your browser can also export its data in the same format for someone to import into Safari. Import bookmarks and Reading List Safari exports bookmarks in an HTML file using the Netscape Bookmarks file format. The Reading List is a sub-folder with the identifier com.apple.ReadingList. Import Safari passwords Safari exports passwords in a comma-separated values (CSV) file that includes a titles row and contains the following columns: Understand JSON metadata Safari exports browser history, extensions, and payment cards as JSON files. The top-level object in each file contains a metadata key, whose value is a JSON object containing these keys: Import browser history The top-level object in the history JSON file contains a history key, which has a value that is an array of objects representing websites that Safari visited. Each object in the array contains these keys: When the web server redirects Safari to a different URL, the history list contains all of the URLs in the chain of redirections. Link items in the redirection chain by comparing the url and time_usec fields in one history item with the destination_url and destination_time_usec of the item that redirected Safari to it, and the source_url and source_time_usec of the item that it redirected Safari to, for example: ... { "url" : "https://maps.apple.com/", "time_usec" : 1722367302951213, "destination_url" : "https://www.apple.com/maps/", "destination_time_usec" : 1722367302951310 }, { "url" : "https://www.apple.com/maps/", "time_usec" : 1722367302951310, "title" : "Maps - Apple", "source_url" : "https://maps.apple.com/", "source_time_usec" : 1722367302951213 }, ... Import payment cards The top-level object in the payment cards JSON file contains a payment_cards key, which has a value that is an array of objects representing the payment cards the person stored in Safari. Each object in the array contains these keys: The object looks like this example: { "card_number" : "0000000000000000", "card_name" : "My Bank Card", "cardholder_name" : "Mei Chen", "card_expiration_month" : 11, "card_expiration_year" : 2027, "card_last_used_time_usec" : 1722730594744987 } Import extension information The top-level object in the extensions JSON file contains an extensions key, which has a value that is an array of objects representing the Safari App Extensions, Safari Web Extensions, and Safari Content Blockers that the person installed and enabled in their Safari profile. Each object in the array contains these keys: The marketplace_lookup object contains these keys: For more information on bundle identifiers, see CFBundleIdentifier. ## See Also ### Safari content in your app - [SFSafariViewController](safariservices/sfsafariviewcontroller.md) - [SFAuthenticationSession.CompletionHandler](safariservices/sfauthenticationsession/completionhandler.md) - [SFSafariSettings](safariservices/sfsafarisettings.md)