Accessing a Footnote Number in VBA

Written by Allen Wyatt (last updated November 27, 2023)
This tip applies to Word 2007, 2010, 2013, 2016, 2019, and 2021


2

Paul is trying to use Word VBA to return the footnote number of the footnote in which the insertion point is located. In his case, it is possible that the footnote contains more than one paragraph. Paul wonders if there is a way to determine this footnote number in VBA.

It is possible to determine a footnote number by using the Index property of a footnote object. Here's a quick way to demonstrate how this info can be useful:

Sub GetFootnoteNumber()
    Dim f As Footnote
    Dim sTemp As String

    sTemp = "The insertion point is not in a footnote"
    For Each f In ActiveDocument.Footnotes
        If Selection.InRange(f.Range) Then
            sTemp = "The insertion point is in footnote " & f.Index
        End If
    Next
    MsgBox sTemp
End Sub

Note that the macro steps through each footnote in the document. If it is determined that the selection (insertion point) is in a particular footnote, then the Index property of that footnote is used to put a message in the sTemp variable. Once done looping through the footnotes, the sTemp variable is displayed in a message box.

If you have a lot of footnotes in your document, you might not want to loop through all of them. In that case, you can use the Information property of the selection to determine if the insertion point is currently in a footnote, in this manner:

Sub GetFootnoteNum()
    Dim J As Integer
    Dim sTemp As String

    sTemp = "The insertion point is not in a footnote"
    If Selection.Information(wdInFootnote) Then
        J = Selection.Paragraphs(1).Range.Footnotes(1).Index
        sTemp = "The insertion point is in footnote " & J
    End If
    MsgBox sTemp
End Sub

In addition, you can derive other information about a particular footnote by expanding what properties of that footnote you access. The following macro returns not only the footnote number, but also the numbering rule, the numbering style, and the starting number for the footnotes:

Sub GetFootnoteInfo()
    Dim f As Footnote
    Dim sTemp As String
    
    sTemp = "The insertion point is not in a footnote"
    If Selection.Information(wdInFootnote) Then
        Set f = Selection.Paragraphs(1).Range.Footnotes(1)
        sTemp = "Footnote number: " & f.Index & vbCr
        With f.Range.FootnoteOptions
            sTemp = sTemp & "Numbering Rule: " & .NumberingRule & vbCr & _
              "Numbering Style: " & .NumberStyle & vbCr & _
              "Starting Number: " & .StartingNumber
        End With
    End If
    MsgBox sTemp
End Sub

Note:

If you would like to know how to use the macros described on this page (or on any other page on the WordTips sites), I've prepared a special page that includes helpful information. Click here to open that special page in a new browser tab.

WordTips is your source for cost-effective Microsoft Word training. (Microsoft Word is the most popular word processing software in the world.) This tip (5906) applies to Microsoft Word 2007, 2010, 2013, 2016, 2019, and 2021.

Author Bio

Allen Wyatt

With more than 50 non-fiction books and numerous magazine articles to his credit, Allen Wyatt is an internationally recognized author. He is president of Sharon Parq Associates, a computer and publishing services company. ...

MORE FROM ALLEN

Understanding Smart Cut and Paste

Editing is generally made easier by a feature that Word calls smart cut and paste. If you prefer, you can turn the ...

Discover More

Generating Unique Numbers for Worksheets

You may need to automatically generate unique numbers when you create new worksheets in a workbook. Here's a couple of ...

Discover More

Setting a Document Naming Convention

Want your document file names to follow a specific naming convention? Word doesn't provide a direct way to set up your ...

Discover More

The First and Last Word on Word! Bestselling For Dummies author Dan Gookin puts his usual fun and friendly candor back to work to show you how to navigate Word 2019. Spend more time working and less time trying to figure it all out! Check out Word 2019 For Dummies today!

More WordTips (ribbon)

Controlling the Bold Text Attribute

When processing a document in a macro, you may need to make some of your text bold. It's easy to do using the Bold ...

Discover More

Determining the Current Directory

When creating macros, it is often necessary to know which directory is the default. Here's how you can find out by using ...

Discover More

Converting Words into Numbers

Sometimes you need to spell-out numbers in a document. When you have spelled-out numbers, at some point you might want to ...

Discover More
Subscribe

FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."

View most recent newsletter.

Comments

If you would like to add an image to your comment (not an avatar, but an image to help in making the point of your comment), include the characters [{fig}] (all 7 characters, in the sequence shown) in your comment text. You’ll be prompted to upload your image when you submit the comment. Maximum image size is 6Mpixels. Images larger than 600px wide or 1000px tall will be reduced. Up to three images may be included in a comment. All images are subject to review. Commenting privileges may be curtailed if inappropriate images are posted.

What is two minus 0?

2020-04-19 05:07:51

Ken

A selection can contain more than one paragraph and you need to specify specify which. If the selection is only only part of a paragraph or is an insertion point in the paragraph, then you must still specify the first (1) and you will get the the whole paragraph.

In a similar way, a range could contain multiple footnotes so you need to specify the first even though in this case it will have only one.

The logic of the compound statement is:
"Selection.Paragraphs(1)" gives a Paragraph object
".Range" gives the range of the paragraph
".Footnotes(1)" gives the Footnote object of the first footnote in the range
".Index" gives the index number of the Footnote object.


2020-04-18 04:51:08

Simon Freeman

I am a bit puzzled. Why the "1" in brackets after Paragraphs and Footnotes in: "Set f = Selection.Paragraphs(1).Range.Footnotes(1)"? Thanks.


This Site

Got a version of Word that uses the ribbon interface (Word 2007 or later)? This site is for you! If you use an earlier version of Word, visit our WordTips site focusing on the menu interface.

Videos
Subscribe

FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."

(Your e-mail address is not shared with anyone, ever.)

View the most recent newsletter.