• Outlook User
  • New Outlook app
  • Outlook.com
  • Outlook Mac
  • Outlook & iCloud
  • Developer
  • Microsoft 365 Admin
    • Common Problems
    • Microsoft 365
    • Outlook BCM
    • Utilities & Addins

Inserting Addresses into Word Documents

Slipstick Systems

› Outlook › People › Inserting Addresses into Word Documents

Last reviewed on September 16, 2019     24 Comments

One of the advantages to using Microsoft Exchange or Microsoft Outlook is the ability to use information from the Address Book in Microsoft Word documents. Exactly how to do it, though, isn't obvious. The key is an AutoText entry called AddressLayout in English (see Non-English Word for the correct name in other languages). This article shows you how to change this entry and how to add an Insert Address button to the Word toolbar. See More Information at the end of this article for alternative methods of putting addresses into Word documents.

Adding an Insert Address button | Changing the Address Layout
Non-English Word | Notes | More Information

Adding an Insert Address button

Word 7.0 includes an Insert Address button on its Standard toolbar, but newer versions of Word don't add the button to the Toolbar or ribbon. If you're going to add address information to documents frequently, having a button available will make it easier. Here's how to add it to a toolbar:

  1. In Word, choose View | Toolbars | Customize, then switch to the Commands tab..
  2. Under Categories, choose Insert.
  3. Near the bottom of the Commands list, you'll find Address Book. Drag that command to any toolbar currently displayed in Word.

The Insert Address button makes it easy to add an address to any document.

Changing the Address Layout

Word includes a default AddressLayout entry that you can't see or edit directly. Test it by using the Insert Address button to insert an address from your Address Book.

To add, remove or rearrange fields, create a new layout in a Word document, then save it as a new AutoText entry named AddressLayout. (If you have a non-English version of Word, see Non-English Word below.)

The following table lists each field you can use, indicates whether it applies to addresses from the Personal Address Book (PAB) or Outlook Contacts (OAB) and lists the corresponding field name in the OAB and PAB.

Fields marked with an asterisk (*) may work only in Word 2000.

AddressLayout FieldContacts (OAB) or
Personal Address Book (PAB)
Field Name
OABPAB
Name Fields
<PR_DISPLAY_NAME>Subject (by default, First Last Middle Suffix) (OAB)
First Last or Last, First (PAB, depending on setting)
XX
<PR_GIVEN_NAME>FirstXX
<PR_SURNAME>LastXX
<PR_TITLE>Job Title (OAB)
Title (PAB)
XX
<PR_DISPLAY_NAME_PREFIX>*Title (OAB)X?
Company Fields
<PR_COMPANY_NAME>CompanyXX
<PR_DEPARTMENT_NAME>DepartmentXX
<PR_OFFICE_LOCATION>Office Location (OAB)
Office (PAB)
XX
<PR_ASSISTANT>AssistantXX
Address Fields
<PR_STREET_ADDRESS>StreetXX
<PR_LOCALITY>CityXX
<PR_STATE_OR_PROVINCE>State/ProvinceXX
<PR_POSTAL_CODE>ZIP/Postal codeXX
<PR_COUNTRY>CountryXX
<PR_POSTAL_ADDRESS>Full address, including country only if it's not your own
Phone Fields
<PR_OFFICE_TELEPHONE_NUMBER>BusinessXX
<PR_OFFICE2_TELEPHONE_NUMBER>Business 2XX
<PR_PRIMARY_TELEPHONE_NUMBER>Phone number (on Business tab)X
<PR_BUSINESS_FAX_NUMBER>Business FaxX
<PR_PRIMARY_FAX_NUMBER>FaxX
<PR_ASSISTANT_TELEPHONE_NUMBER>Assistant (on Phone pick list) (OAB)
Assistant (on Phone Numbers tab) (PAB)
XX
<PR_BEEPER_TELEPHONE_NUMBER>PagerXX
<PR_CAR_TELEPHONE_NUMBER>CarX
<PR_CELLULAR_TELEPHONE_NUMBER>MobileXX
<PR_RADIO_TELEPHONE_NUMBER>RadioX
<PR_HOME_TELEPHONE_NUMBER>HomeXX
<PR_HOME2_TELEPHONE_NUMBER>Home 2XX
<PR_HOME_FAX_NUMBER>Home FaxX
<PR_OTHER_TELEPHONE_NUMBER>OtherX
Other Fields
<PR_EMAIL_ADDRESS>E-mail AddressXX
<PR_ADDRTYPE>E-mail TypeXX
<PR_COMMENT>NotesX

An example is the easiest way to show how to create a new layout. If you want to add the job title and company name to the layout and remove the country name, type (or copy and paste) this into Word, with a carriage return after each line:

<PR_GIVEN_NAME> <PR_SURNAME> <PR_TITLE> <PR_COMPANY_NAME> <PR_STREET_ADDRESS> <PR_LOCALITY>, <PR_STATE_OR_PROVINCE> <PR_POSTAL_CODE>

Make sure you include spaces and punctuation where you want them to appear in the address. Now, select the entire layout, and save it as an AutoText entry with the name "AddressLayout," taking care to use exactly that spelling and capitalization.

To save an AutoText entry in Word 7.0, choose Edit | AutoText, enter the Name as "AddressLayout," then click Add.

To save an AutoText entry in Word 97 or Word 2000/2002/2003, choose Insert | AutoText | New, enter "AddressLayout" as the name, then click OK.

You can now use the Insert Address button to test your new AddressLayout. The above example should give you an address that looks like this:

Bill GatesCEOMicrosoft CorporationOne Microsoft WayRedmond, WA 98052

You might notice, though, that if a person has no title, you get a blank line. To suppress blank lines and make use of different fields that display the same data, depending on whether the source is a PAB or OAB entry, try this variation from the Office 97 Resource Kit, omitting the carriage returns:

{{<PR_GIVEN_NAME> <PR_SURNAME> | <PR_DISPLAY_NAME>}\r} {{<PR_STREET_ADDRESS>\r}{{<PR_LOCALITY>} {, <PR_STATE_OR_PROVINCE> <PR_POSTAL_CODE>}\r} {<PR_COUNTRY>\r}| <PR_POSTAL_ADDRESS>\r}

The curly braces ( {} ) are used to ensure that a particular line does not print if it is empty, for example, if the person does not have a title. The vertical bar ( | ) means OR. And the \r switch substitutes for the carriage return. (Omit the \r in Word 2000 and just put a carriage return or soft return after each line; the \r switch doesn't work in Word 2000.) You are limited to a total of 12 fields, according to WD2000: How to Modify the Layout of an Address Book Entry.

For Office XP, this turns out to be a pretty good AddressLayout entry to include both company and country. I suspect it might also work well in Office 2000. You should put a carriage return or soft return at the end of each line shown here:

{{<PR_GIVEN_NAME> <PR_SURNAME> | <PR_DISPLAY_NAME>} }{<PR_COMPANY_NAME>} {{<PR_STREET_ADDRESS> }{{<PR_LOCALITY>}{, <PR_STATE_OR_PROVINCE> <PR_POSTAL_CODE>}} {<PR_COUNTRY> }| <PR_POSTAL_ADDRESS>}

If the address doesn't work the way you think it should, check the field names for spelling mistakes and make sure that you actually have information entered in the corresponding Contacts or PAB fields. Also, if the addresses were imported, you may need to follow the instructions in MSKB article Address Displays Incorrectly on Imported Contacts.

Another approach is to simply make sure that the Address field contains whatever you want printed after the name, repeating the company name or other information as needed.

Non-English Word

If you are using a non-English version of Word, AddressLayout may not be the correct name for the AutoText entry that you need to modify. If you discover what the correct name is for a particular language, please let us know and we'll add it to this list:

  • Dutch -- AdresIndeling
  • French -- MiseEnPageAdresse
  • German -- Adreßlayout or Adresslayout
  • Italian -- IndirizzoLayout
  • Nordic languages -- AdresseLayout
  • Spanish -- AddressLayout
  • Turkish – AdresD’zeni

Notes

If you want to write a Word macro to insert addresses, use the GetAddress method. This also gives you the option of specifying an address layout, rather than using the AddressLayout entry from AutoText. There's a good example in the VBA help file in Word.

Additional notes on the fields:

  • In an Outlook contact, if you edit the Subject field, subsequent changes to any name field will cause the Subject field also to change. If you are using the Reorder Contacts form to change the way addresses are displayed in the Outlook Address Book, you should use the <PR_GIVEN_NAME> and <PR_SURNAME> fields in the AddressLayout entry, rather than <PR_DISPLAY_NAME>. Also, <PR_DISPLAY_NAME> may show the (E-mail) suffix for contacts from the Outlook Address Book.
  • For Outlook Contacts, the <PR_EMAIL_ADDRESS> and <PR_ADDRTYPE> fields work with the E-mail field only. There are no corresponding fields for the E-mail 2 and E-mail 3 addresses.
  • In Outlook, the Country field is often filled in by default with a value determined by your regional settings (Control Panel | Regional Settings). Click Address on the Contacts record to check the value placed in Country field.

More Information

Although many of these articles were written for Office 2000, in most cases the code will work in all later versions of Office.

  • To start a Word letter from a Microsoft Outlook contact
  • Insert Outlook contact information into Word documents -- sample VBA code
Inserting Addresses into Word Documents was last modified: September 16th, 2019 by Diane Poremsky

Related Posts:

  • Inserting Outlook Contact Addresses into Envelopes
  • Start a Word letter from an Outlook contact
  • Printing Labels or Envelopes for Contacts
  • How to Print Outlook Address Books

About Diane Poremsky

A Microsoft Outlook Most Valuable Professional (MVP) since 1999, Diane is the author of several books, including Outlook 2013 Absolute Beginners Book. She also created video training CDs and online training classes for Microsoft Outlook. You can find her helping people online in Outlook Forums as well as in the Microsoft Answers and TechNet forums.

Subscribe
Notify of
24 Comments
newest
oldest most voted
Inline Feedbacks
View all comments

Chaya Jampolsky
January 3, 2016 1:18 am

I too would like to insert a contact from Outlook 2010 to Word 2010. I have tried to follow the discussion over here but I am not a programmer. I am not familiar with the getaddress function. I have found the following code on a website that seems to be what I am looking for:

Dim strAddress, strCode, strFnamn, strEnamn, strTel, strMobil, strEpost, As String

strFnamn = ""
strEnamn = ""
strTel = ""
strMobil = ""
strEpost = ""

strCode = strFnamn & "$1" & strEnamn & "$2" & strTel & "$3" & strMobil &
"$4" & strEpost

strAddress = Application.GetAddress(AddressProperties:=strCode,
DisplaySelectDialog:=1)

MsgBox strAddress

The above are the exact fields I need to put into a table in the word document. But where do I put it and how do I run it?

0
0
Reply
Michael Boughman
November 7, 2014 2:09 pm

Hi, I have found code using getaddress to insert an Outlook contact into Word. I am using this to populate a quote template. This works fine. I am not a programmer so my question may be simple. Is there a way to insert just the first name "PR_GIVEN_NAME" from the getaddress results at another bookmark location to be used as a salutation?

'Set up the formatting codes in strCode
strCode = " " & vbCr & _
"" & vbCr & _
""

'Display the 'Select Name' dialog, which lets the user choose
'a name from their Outlook address book
strName = Application.GetAddress(addressproperties:=strCode, _
UseAutoText:=False, DisplaySelectDialog:=1, _
recentaddresseschoice:=True, UpdateRecentAddresses:=True)

'If user cancelled out of 'Select Name' dialog, quit
If strName = "" Then Exit Sub

'Insert the name at the current insertion point
Selection.Range.Text = strName

0
0
Reply
Diane Poremsky
Reply to  Michael Boughman
November 16, 2014 8:27 pm

Yeah, you can insert it at any bookmark - assuming strname is the given name,
With oWord
' Find the bookmark, insert an Outlook field
.Selection.GoTo What:=wdGoToBookmark, Name:="bookmark name"
.Selection.TypeText Text:=strName
Full macro us here - it uses contact field directly but you can replace the field names with strings holding the values. (Or you might find it easier to use the contact fields directly).
https://www.slipstick.com/developer/create-letter-contact-vba/

0
0
Reply
Ulf Nilsson
January 16, 2014 2:13 am

Hi,
I found a solution: One can get the telephone number, PR_OFFICE_TELEPHONE_NUMBER, and use this unique item to locate the user in the Active Directory and get the mail address through this.

0
0
Reply
Diane Poremsky
Reply to  Ulf Nilsson
January 16, 2014 9:27 am

That is a little more convoluted than the method i found once (and haven't been able to find again).

0
0
Reply
Ulf Nilsson
January 7, 2014 6:52 am

Hi,
How is it going?

0
0
Reply
Diane Poremsky
Reply to  Ulf Nilsson
January 20, 2014 11:53 pm

I haven't had a lot of time to work on it, but the code I found didn't work right.

0
0
Reply
Ulf Nilsson
November 7, 2013 10:25 pm

Thanks!
I am really looking forward to it!

0
0
Reply
Ulf Nilsson
November 7, 2013 4:00 am

I am looking for the SMTP address, that is the email address.

0
0
Reply
Diane Poremsky
Reply to  Ulf Nilsson
November 7, 2013 8:22 am

I'll see if i can find some code that can grab it.

0
0
Reply
Ulf Nilsson
November 5, 2013 5:38 am

Your code is correct, but I do not get the email address. I only get what is called legacyExchangeDN. In older versions that string contained the username (which I uesed in simular matter as Environ("username")). But in Exchange 2012, it doesn't.

0
0
Reply
Ulf Nilsson
November 5, 2013 12:57 am

Hi,
Your code is correct one. Something strange happens when I paste my code to this page... Strange.
The result with the pr_email_address-code is the legacyExchangeDN-code. In previous versions of Exchange, it ends with the username.
With the Exchange 2012 it adds (FYDIBOHF23SPDLT) (which is equal to Exchange12Rocks - F=E; Y=X, D=C, and so on) and removes the username and add something else.
In previous versions, I used the username in the same way as Environ("username"), but I cannot do it now with the new version of Exchange.

0
0
Reply
Diane Poremsky
Reply to  Ulf Nilsson
November 5, 2013 7:26 am

do you want the SMTP address or the user name? You can get either, but need to use a bit of code.

0
0
Reply

Visit Slipstick Forums.
What's New at Slipstick.com

Latest EMO: Vol. 30 Issue 29

Subscribe to Exchange Messaging Outlook






Support Services

Do you need help setting up Outlook, moving your email to a new computer, migrating or configuring Office 365, or just need some one-on-one assistance?

Our Sponsors

CompanionLink
ReliefJet
  • Popular
  • Latest
  • Week Month All
  • Jetpack plugin with Stats module needs to be enabled.
  • Move Deleted Items to Another Folder Automatically
  • Open Outlook Templates using PowerShell
  • Count and List Folders in Classic Outlook
  • Google Workspace and Outlook with POP Mail
  • Import EML Files into New Outlook
  • Opening PST files in New Outlook
  • New Outlook: Show To, CC, BCC in Replies
  • Insert Word Document into Email using VBA
  • Delete Empty Folders using PowerShell
  • Warn Before Deleting a Contact
Ajax spinner

Recent Bugs List

Microsoft keeps a running list of issues affecting recently released updates at Fixes or workarounds for recent issues in classic Outlook (Windows).

For new Outlook for Windows: Fixes or workarounds for recent issues in new Outlook for Windows .

Outlook for Mac Recent issues: Fixes or workarounds for recent issues in Outlook for Mac

Outlook.com Recent issues: Fixes or workarounds for recent issues on Outlook.com

Office Update History

Update history for supported Office versions is at Update history for Office

Outlook Suggestions and Feedback

Outlook Feedback covers Outlook as an email client, including Outlook Android, iOS, Mac, and Windows clients, as well as the browser extension (PWA) and Outlook on the web.

Outlook (new) Feedback. Use this for feedback and suggestions for Outlook (new).

Use Outlook.com Feedback for suggestions or feedback about Outlook.com accounts.

Other Microsoft 365 applications and services




New Outlook Articles

Move Deleted Items to Another Folder Automatically

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Google Workspace and Outlook with POP Mail

Import EML Files into New Outlook

Opening PST files in New Outlook

New Outlook: Show To, CC, BCC in Replies

Insert Word Document into Email using VBA

Delete Empty Folders using PowerShell

Warn Before Deleting a Contact

Newest Code Samples

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Insert Word Document into Email using VBA

Warn Before Deleting a Contact

Use PowerShell to Delete Attachments

Remove RE:, FWD:, and Other Prefixes from Subject Line

Change the Mailing Address Using PowerShell

Categorize @Mentioned Messages

Send an Email When You Open Outlook

Delete Old Calendar Events using VBA

Repair PST

Convert an OST to PST

Repair damaged PST file

Repair large PST File

Remove password from PST

Merge Two Data Files

Sync & Share Outlook Data

  • Share Calendar & Contacts
  • Synchronize two computers
  • Sync Calendar and Contacts Using Outlook.com
  • Sync Outlook & Android Devices
  • Sync Google Calendar with Outlook
  • Access Folders in Other Users Mailboxes

Diane Poremsky [Outlook MVP]

Make a donation

Mail Tools

Sending and Retrieval Tools

Mass Mail Tools

Compose Tools

Duplicate Remover Tools

Mail Tools for Outlook

Online Services

Calendar Tools

Schedule Management

Calendar Printing Tools

Calendar Reminder Tools

Calendar Dates & Data

Time and Billing Tools

Meeting Productivity Tools

Duplicate Remover Tools

Productivity

Productivity Tools

Automatic Message Processing Tools

Special Function Automatic Processing Tools

Housekeeping and Message Management

Task Tools

Project and Business Management Tools

Choosing the Folder to Save a Sent Message In

Run Rules on messages after reading

Help & Suggestions

Submit Outlook Feature Requests

Slipstick Support Services

Buy Microsoft 365 Office Software and Services

Visit Slipstick Forums.

What's New at Slipstick.com

Home | Outlook User | Exchange Administrator | Office 365 | Outlook.com | Outlook Developer
Outlook for Mac | Common Problems | Utilities & Addins | Tutorials
Outlook & iCloud Issues | Outlook Apps
EMO Archives | About Slipstick | Slipstick Forums
Submit New or Updated Outlook and Exchange Server Utilities

Send comments using our Feedback page
Copyright © 2025 Slipstick Systems. All rights reserved.
Slipstick Systems is not affiliated with Microsoft Corporation.

:wpds_smile::wpds_grin::wpds_wink::wpds_mrgreen::wpds_neutral::wpds_twisted::wpds_arrow::wpds_shock::wpds_unamused::wpds_cool::wpds_evil::wpds_oops::wpds_razz::wpds_roll::wpds_cry::wpds_eek::wpds_lol::wpds_mad::wpds_sad::wpds_exclamation::wpds_question::wpds_idea::wpds_hmm::wpds_beg::wpds_whew::wpds_chuckle::wpds_silly::wpds_envy::wpds_shutmouth:
wpDiscuz

Sign up for Exchange Messaging Outlook

Our weekly Outlook & Exchange newsletter (bi-weekly during the summer)






Please note: If you subscribed to Exchange Messaging Outlook before August 2019, please re-subscribe.

Never see this message again.

You are going to send email to

Move Comment