The Excel GETPIVOTDATA Function

Basic Description

The Excel GETPIVOTDATA function extracts data from specified fields of an Excel Pivot Table.

The syntax of the function is:

GETPIVOTDATA( data_field, pivot_table, [field1], [item1], [field2], [item2], ...)

where the function arguments are:

data_field-The pivot table data field (i.e. the value(s) in the center of the table) that you want to retrieve.
pivot_table-A reference to a range of cells within a Pivot Table (used to specify the pivot table to be searched).
[field1], [item1],
[field2], [item2],
etc
-

Up to 126 optional pairs of fields and item names, (i.e. The row and column headers and individual categories) for which you want the returned value.

Note: The item values should be entered as follows:

  • Numbers can be entered directly;
  • Dates should be entered as date serial numbers or by using the date function;
  • Times should be entered as decimals or by using the time function;
  • Text values should be entered in quotations.

Note that, if the requested fields are not visible in the specified Pivot Table, the Getpivotdata function returns the #REF! error.

Automatically Insert the Getpivotdata Function

If the 'Use GetPivotData functions for PivotTable references' Excel option is enabled, the easiest way to input the Getpivotdata function is simply to type "=" into a cell and then click on the Pivot Table value that you want to return. Excel then automatically inserts the Getpivotdata function into the active cell.

(Note: the 'Use GetPivotData functions for PivotTable references' option is located in the 'Formulas' section of the 'Excel Options' dialog box, which is accessed from the 'File' tab of Excel).


Getpivotdata Function Examples

The examples below all refer to the following Pivot Table, which is located in columns A - G of the current Excel Worksheet.

 ABCDEFG 
1        
2Sum of Invoice Amount TotalItem Type  
3DateSalespersonDigital
TV
DVD
Player
IpodComputerGrand Total 
4JanJohn$68,600$13,800$6,840$69,600$158,840 
5Kevin$64,400$7,800$12,780$36,800$121,780 
6Pete$46,200$2,400$2,700$25,600$76,900 
7Jan Total$179,200$24,000$22,320$132,000$357,520 
8FebJohn$68,600$8,400$9,720$52,800$139,520 
9Kevin$61,600$4,500$7,920$43,200$117,220 
10Pete$29,400$3,900$6,300$33,600$73,200 
11Feb Total$159,600$16,800$23,940$129,600$329,940 
12MarJohn$71,400$9,300$7,560$80,000$168,260 
13Kevin$70,000$10,200$13,680$58,400$152,280 
14Pete$43,400$5,400$3,240$40,800$92,840 
15Mar Total$184,800$24,900$24,480$179,200$413,380 
16Grand Total$523,600$65,700$70,740$440,800$1,100,840 
17        


=GETPIVOTDATA( "Invoice Amount", $A$2, "Date", "Jan" )

- Returns the value $357,520, which is the value of the Invoice Amount Total for all of the Date field, "Jan".


=GETPIVOTDATA( "Invoice Amount", $A$2, "Date", "Feb", "Item Details", "IPod" )

- Returns the value $23,940, which is the value of the Invoice Amount Total for the Date field, "Feb" and the Item Details field, "IPod".


=GETPIVOTDATA( "Invoice Amount", $A$2, "Date", "Feb", "Item Details", "IPod", "Salesperson", "Kevin" )

- Returns the value $7,920, which is the value of the Invoice Amount Total for the Date field, "Feb", the Item Details field, "IPod", and the Salesperson field "Kevin".


=GETPIVOTDATA( "Invoice Amount", $A$2, "Salesperson", "Kevin" )

- Returns the Excel #REF! error as the Pivot Table doesn't show the totals for the Salesperson "Kevin".


Further information on the Getpivotdata Function is provided on the Microsoft Office website.


Getpivotdata Function Error

If you get an error from the Excel Getpivotdata function, this is likely to be the #REF! error:

Common Error
#REF!-

Occurs if either:

  • The supplied pivot_table reference does not relate to a pivot table;
  • Any of the fields specified by the data_field, [field] or [item] arguments are not valid fields within the specified pivot table;
  • The field details are not displayed in the specified pivot table (e.g. total sales figures for SalesPerson 'Kevin' are not displayed in the example spreadsheet above).