Windows Contacts
Windows Contacts is a contact management technology and file format introduced by Microsoft in Windows Vista to store and organize personal contact information in an extensible XML-based schema, serving as a replacement for the earlier Windows Address Book (WAB) and enabling synchronization with devices and applications.[1] Developed to unify contact data across Microsoft platforms, Windows Contacts uses individual .contact files stored in the user's local Contacts folder (typically located at %USERPROFILE%\Contacts), allowing for properties such as names, email addresses, phone numbers, and custom fields defined by URIs for multi-value support.[1] The system provides Component Object Model (COM) interfaces and APIs, including IContact, IContactManager, and IContactProperties, for developers to read, write, and manipulate contacts programmatically.[2] Key features include built-in versioning with modification timestamps, backward compatibility with WAB through legacy interfaces, and two levels of extensibility: a simple built-in model for standard properties and a full XML model for custom schemas.[1] In Windows Vista and Windows 7, Windows Contacts was directly accessible via the wab.exe executable or integrated into applications like Windows Mail, supporting import/export in formats like CSV and vCard while emphasizing XML for interoperability without fully replacing vCard.[1] With the release of Windows 8, 10, and early Windows 11 versions, the functionality evolved into the legacy People app, which aggregated contacts from local Windows Contacts storage and cloud services like Microsoft accounts, Outlook.com, and Google, providing a unified view while maintaining the underlying .contact files for local use.[3] As of 2025, the legacy People app has been deprecated and removed from new Windows 11 installations, replaced by a new Microsoft 365 companion People app available to subscribers for cloud-integrated contact management.[4] Users can still access and manage the legacy Windows Contacts folder through File Explorer for tasks like printing or exporting, though the app-based interface is recommended for modern workflows.[5] Although designed for broad integration, including device synchronization for cell phones and PDAs, the Windows Contacts APIs are now deprecated and marked as "do not use" in current documentation, with Microsoft encouraging developers to migrate to newer platforms like Microsoft Graph for contact management in Microsoft 365 ecosystems.[2] This shift reflects the technology's role as a transitional system, bridging older standalone address books to cloud-centric solutions while preserving local data persistence. As of late 2025, Microsoft has introduced companion apps for Microsoft 365, including the new People app, to further integrate contact management with cloud services on Windows 11.[6]History
Origins and Introduction
Windows Contacts emerged as a successor to the Windows Address Book (WAB), which served as the primary contact management system in Windows 98 through Windows XP. The WAB stored contacts in a proprietary binary .wab file format, enabling basic sharing of contact lists across applications like Outlook Express but limiting advanced data manipulation and integration.[7][8] Introduced with Windows Vista in 2007, Windows Contacts debuted as a dedicated special folder designed to centralize contact storage and facilitate seamless retrieval for various Microsoft applications, marking a significant overhaul in how the operating system handled personal address data.[9][10] This transition addressed key shortcomings of the WAB, including its lack of support for open standards like XML and constrained extensibility for custom fields or third-party integrations, by shifting to a more flexible, standards-compliant architecture that enhanced interoperability and developer accessibility.[1][1] Initially, Windows Contacts was housed in a user-specific special folder located at %UserProfile%\Contacts within the Windows user profile directory, allowing for straightforward access and organization of individual .contact files.[11] Later iterations, such as the People app in Windows 8, built upon this foundation for modern synchronization needs.Evolution Across Windows Versions
Windows Contacts, introduced in Windows Vista as a replacement for the Windows Address Book (WAB), provided a unified platform for storing and managing personal contact information across Microsoft applications and services.[1] This shift aimed to simplify contact handling with an extensible XML-based format, supporting backward compatibility for legacy uses while enabling synchronization with devices like cell phones.[1] In Windows 7 (released in 2009), Windows Contacts remained largely unchanged from Windows Vista. The folder continued as a special, offline-only repository at C:\Users[username]\Contacts, maintaining compatibility with applications like Windows Mail.[12][1] Windows 8 (2012) marked a reduced prominence for the traditional Contacts folder amid the introduction of the Metro (now Modern) interface, which prioritized touch-friendly apps. The desktop-mode Contacts folder was retained unchanged from previous versions for backward compatibility with legacy desktop applications, but the new People app became the primary interface for contact management, integrating online accounts like Microsoft Account for syncing.[13][14] With Windows 10 (2015), Windows Contacts was officially designated as legacy, with the feature and its API deprecated in version 1803 (April 2018); Microsoft recommended the People app as the main tool for maintaining contacts and lists, which pulled from cloud services for a more integrated experience. The local Contacts folder persisted solely for backward compatibility, allowing import/export but no new enhancements.[15] In Windows 11 (2021), legacy support for the Contacts folder continued without additional features, as the emphasis shifted further to cloud-based synchronization via Microsoft Account in the People app, Mail app, or Outlook. Users access contacts primarily through these modern interfaces, with the traditional folder available but de-emphasized.[16][15] Microsoft documentation reaffirms the XML format's role in unifying contacts across applications, providing a standardized schema for properties like names, emails, and custom extensions while supporting interoperability without replacing formats like vCard.[1]Core Functionality
Contact Storage and Organization
Windows Contacts stores each individual contact as a separate .contact file in XML format within the user's Contacts folder, typically located at C:\Users<username>\Contacts.[17][1] This file-based approach allows for straightforward management of personal contact data, including support for custom information such as pictures and extensible properties defined by an XML schema. Users organize contacts primarily through Windows Explorer, where manual sorting is achieved by clicking column headers to arrange files by attributes like name, date modified, or type. Grouping is facilitated by creating subfolders via the Organize menu or right-click context menu, enabling users to drag and drop .contact files into categorized subdirectories for better structure.[18] Basic search functionality within the folder uses the integrated search box in Windows Explorer to locate contacts by file name or content keywords. The Contacts folder also integrates with Windows Search for broader system-wide querying of contact details. Editing a contact involves double-clicking the corresponding .contact file in the folder, which launches the built-in editor for modifying standard fields including full name, email addresses, phone numbers, physical addresses, notes, and custom properties added via XML extensions.[19][1] Changes are saved directly to the file upon closing the editor, ensuring updates are immediately reflected in the folder. Viewing options in the Contacts folder leverage Windows Explorer's display modes, such as list view for compact icons, details view for tabular information with columns like name and size, or tiles view for larger previews. Enabling the preview pane provides a quick summary of the selected contact's key details without opening the full editor. For printing, users select one or more contacts in the folder, access the Print command from the toolbar or context menu, and choose formats like business card, phone list, or memo to generate output via the system's print dialog.[20]Import and Export Capabilities
Windows Contacts supports importing contacts from several standard formats, including vCard (.vcf) files, Comma-Separated Values (CSV), Windows Address Book (WAB) from legacy systems, and LDAP Data Interchange Format (LDIF).[21] These formats enable users to transfer contact data from external sources such as email clients, mobile devices, or directory services into the local Contacts folder. The import process begins by navigating to the Contacts folder, typically located atC:\Users\%username%\Contacts, and accessing the import function via the toolbar or by right-clicking in an empty area of the folder view and selecting Import. Users then choose the desired format from the options—vCard, CSV, WAB, or LDIF—browse to select the source file, and proceed through a wizard that allows mapping of fields (e.g., aligning name, email, or phone number columns from the source to corresponding Windows Contacts properties). The wizard also provides options to handle potential duplicates by prompting users to replace, skip, or merge entries based on matching criteria like email addresses.[22]
For exporting contacts, Windows Contacts offers support for vCard and CSV formats.[23] To export, users open the Contacts folder, select Export from the toolbar or right-click menu, choose the format, specify a destination file or folder, and map fields if needed for CSV output. Individual contacts can also be exported as single vCard files by right-clicking the contact and selecting options like "Send as vCard," though this may omit certain details such as photos or notes. The exported data draws from the underlying XML structure of individual .contact files stored in the folder.[22]
While imports and exports can be performed in batch mode directly through Windows Explorer's interface on the Contacts folder, there is no built-in tool for automatic deduplication during these operations, requiring manual review or third-party assistance for large datasets.[21]
Technical Specifications
File Format and Structure
Windows Contacts primarily utilizes XML-based .contact files to store individual contact records, providing a human-readable format that adheres to a predefined schema for organizing personal information.[24] Each .contact file encapsulates details such as names, email addresses, and phone numbers through structured XML elements; for instance, the<contact> root element contains child elements like <name> for personal identifiers (e.g., <givenName> and <familyName>), <email> for addresses, and <phone> for numbers, all defined within the Microsoft Contact Schema.[24] This schema supports both single-value properties, such as gender or notes, and hierarchical collections, like email or phone arrays, ensuring consistent data representation across files.[24]
The overall file structure treats the Contacts folder as a simple container for multiple .contact XML files, without relying on a central database, which allows for straightforward file management and portability.[1] Each XML file is self-contained and versioned, including attributes for modification timestamps to track changes, and it can embed metadata such as categories (via labels like "Business" or custom URIs) and thumbnails through a <photo> collection that supports image data.[24] Timestamps, including creation and last modified dates, are stored as XML attributes or elements (e.g., <creationDate>), facilitating auditing and synchronization.[1]
For backward compatibility, Windows Contacts supports conversion from the legacy Windows Address Book (WAB) format, allowing users to import .wab files directly into the Contacts folder, where they are transformed into the XML-based structure.[9] The schema itself is based on the extensible Microsoft Contact Schema, which permits the addition of custom properties using unique XML namespaces, enabling developers to extend contact data without altering the core format.[24] This design supports brief references in import/export operations, such as converting .contact files to CSV or vCard for interoperability with other applications.[1]
APIs and Extensibility
The Windows Contacts API served as the primary programming interface for developers to interact with contact data in the Windows operating system, replacing the earlier Windows Address Book (WAB) API introduced in Windows Vista to unify contact management across Microsoft applications.[1][25] This COM-based API enables programmatic access to contact storage, allowing applications to read, write, and manage contacts stored in the user's profile folder, with backward compatibility for legacy WAB-dependent software.[2] The API is now deprecated, and Microsoft recommends migrating to newer platforms such as Microsoft Graph.[2] The API provides two tiers of extensibility to accommodate varying developer needs. The basic tier supports reading and writing standard contacts using predefined schemas, enabling simple integrations without custom data structures. The advanced tier allows for the addition of custom properties via unique URIs and the development of synchronization providers to extend functionality, such as integrating with external data sources or devices.[1] Development tools for the Windows Contacts API are included in the Windows SDK, which provides headers, libraries, and samples for C++ and COM programming, facilitating tasks like contact synchronization with mobile devices such as cell phones.[2] Key interfaces include IContact for manipulating individual contact properties and IContactCollection for enumerating and managing sets of contacts, with enumeration achieved through methods in IContactManager that access the contacts folder.[26][27] Custom integrations can leverage XML parsing, as contacts are stored in XML-based .contact files adhering to a defined schema.[24]Integration and Usage
Built-in Windows Integrations
Windows Contacts is indexed by Windows Search, allowing users to quickly retrieve contact details from across the operating system. In earlier versions such as Windows Vista and 7, this integration extended to applications like Windows Mail and Calendar for seamless access during composition or scheduling tasks; however, support for Windows Mail and Calendar ended on December 31, 2024, with users now directed to the new Outlook for Windows app for similar functionality.[28] This ensures that contact names, email addresses, and other fields remain searchable via the Start menu or File Explorer, enhancing productivity in the Windows ecosystem.[1] In Windows Vista and 7, Windows Contacts served as the primary address book for Windows Mail, enabling automatic population of recipient fields when composing emails by drawing directly from stored contact data.[1] Similarly, Windows Live Mail, a successor application available for download until its discontinuation, leveraged Windows Contacts for importing and auto-completing recipient information, facilitating smooth transitions between local storage and email workflows.[1] Windows Contacts integrates with Windows Live Messenger versions up to 8.5, supporting synchronization of contact lists and display of online status within the messaging interface to streamline communication.[1] This linkage allows users to view and update messenger contacts alongside local entries, unifying personal and online communication data until support ended in later versions. As a known shell folder identified by the GUID FOLDERID_Contacts ({56784854-C6CB-462b-8169-88E350ACB882}), Windows Contacts is exposed through the Windows shell namespace, permitting drag-and-drop operations into other system components such as email composers or document fields.[29] This enables intuitive transfer of contact information without manual entry, integrating it natively into file and application interactions starting from Windows Vista.[29]Compatibility with External Applications
Windows Contacts supports interoperability with various email clients primarily through standard import and export formats such as CSV and vCard, enabling users to transfer contact data without direct integration. Following the end of support for the People app on December 31, 2024, contacts can be exported as a CSV file from the new Outlook for Windows app or directly from the local Contacts folder via File Explorer; this CSV is then compatible for import into Microsoft Outlook via its built-in wizard.[28][30] This process allows seamless migration of contact details like names, email addresses, and phone numbers, though older versions of Outlook may require manual field mapping during import to preserve custom data fields.[31] In legacy implementations, such as Windows Vista and 7, export options directly from the Contacts folder include both CSV and vCard formats, facilitating partial synchronization with Outlook Express or earlier clients, but full bidirectional sync typically necessitates an Exchange account.[23] For device synchronization, Windows Contacts extends compatibility with mobile hardware through protocols like Exchange ActiveSync, which allows contacts to be pushed to and pulled from compatible phones when linked via an Exchange server. This enables over-the-air synchronization of contact information, including availability details, to devices running supported operating systems, provided the mobile client adheres to ActiveSync standards.[32] Custom providers can further enhance this extensibility for specific hardware, such as older Windows Mobile devices, by leveraging the protocol's support for secure, encrypted data transfer with policy enforcement like device passwords.[32] Modern alternatives, like Microsoft Phone Link, build on similar principles to sync contacts from Android or iOS devices back to Windows, though this operates bidirectionally and requires app installation on the phone.[33] Third-party applications gain access to Windows Contacts data via the same export mechanisms, with vCard and CSV formats serving as bridges to tools like Mozilla Thunderbird and Google Contacts, as these standards are widely adopted for contact interchange. Users can export individual or bulk contacts to vCard (.vcf) files from the Contacts interface or new Outlook, which Thunderbird imports directly into its address book, though some extended fields (e.g., notes or categories) may not map perfectly without manual adjustment.[23] Similarly, CSV exports facilitate uploads to Google Contacts, where the file is parsed to populate the online address book, supporting cross-service migration without native plugins.[34] However, most external tools lack direct API access to Windows Contacts due to its legacy design, relying instead on file-based transfers rather than real-time integration.[35] The underlying XML-based .contact file format provides cross-platform potential by allowing manual editing in any text editor, as the schema unifies contact elements in a structured, human-readable markup that can be parsed or converted externally.[1] Despite this, native support is absent in non-Windows ecosystems; for example, macOS Contacts app requires conversion to vCard or CSV before import, and iOS devices do not recognize .contact XML files directly, often necessitating third-party converters to avoid data loss during transfer.[36] This format's interoperability is thus limited to conversion workflows, prioritizing backward compatibility over seamless multi-platform use.[24]Known Limitations
Export and Synchronization Issues
Windows Contacts has encountered several documented issues related to exporting and synchronizing contact data, particularly in earlier versions of the operating system. This export limitation ties directly to compatibility problems with Outlook Express, from which Windows Contacts inherited aspects of the WAB system. Exports from Outlook Express to WAB files often fail to preserve any structural elements when imported into Windows Contacts on Vista and later versions, leading to lost categorization or grouping of contacts. Microsoft acknowledged this inherited issue in documentation noting that multiple contact folders defined in the WAB cannot be properly imported, affecting migration paths from older systems to Vista and beyond.[37] Synchronization issues further complicate usage, especially for custom fields. Device synchronization with Windows Contacts often results in incomplete transfers of custom fields, where non-standard data such as user-defined notes or additional attributes fail to sync fully to mobile devices or external applications. For example, synchronization with Google accounts in Windows 8 did not support custom fields.[38] As a workaround for preserving organization during transfers, users can manually copy and paste individual .contact files from subfolders within the %userprofile%\Contacts directory before exporting or transferring.Deprecation and Legacy Status
Windows Contacts has been maintained as a legacy component since its last significant enhancements in Windows 8.1, with no further development or updates provided thereafter.[9] Introduced in Windows Vista as a desktop-based contact storage system using XML-structured .contact files, it transitioned to a secondary role in Windows 8 and later versions, where the modern People app became the primary interface for contact management.[14] By Windows 10 in 2015, it was effectively sidelined in favor of cloud-integrated alternatives, retaining only backward compatibility for existing local data. As of November 2025, the Windows Contacts folder remains present in Windows 11 at%UserProfile%\Contacts for compatibility purposes, allowing users to view and access stored .contact files, though certain functionalities like printing may produce incomplete results due to lack of ongoing support.[5] Microsoft no longer recommends its use for new contact management, instead directing users to the new Outlook for Windows or Outlook.com, following the end of support for the People app on December 31, 2024.[28] The People app, previously the preferred modern replacement, can no longer add or edit contacts post-2024, though existing data remains viewable until migration.[28]
For users transitioning from Windows Contacts, Microsoft advises exporting data to standard formats for import into recommended tools. To export, open the Contacts folder, select contacts via the toolbar, and choose CSV or vCard format to save the files; these can then be imported into new Outlook via its File > Open & Export > Import/Export wizard.[23] Automatic synchronization is available for Microsoft Account-linked contacts, pulling data directly into Outlook without manual export.[30]
Looking ahead, the feature faces likely removal in future Windows releases beyond version 11, aligning with Microsoft's broader strategy to consolidate contact management within the Microsoft 365 ecosystem, emphasizing cloud-based solutions like Outlook over disparate local stores.[28] This unification prioritizes seamless integration across devices and services, reducing reliance on version-specific legacy folders.