AG Studio Launch Week 🚀🚀🚀 28 Sep - 2 Oct 2026 🚀🚀🚀 Join now




Core Features

Advanced Features

JavaScript Data GridPDF Export API Reference

Version 36.1.0
Enterprise

This page documents the PDF Export API and interfaces.

Grid Properties Copy Link

API Methods Copy Link

Interfaces Copy Link

PdfExportParams Copy Link

Properties available on the PdfExportParams interface.

documentTitleCopy Link
string
The document title stored in the PDF metadata. When set, a visible title is rendered above the exported table.
documentTitleStyleCopy Link
PdfDocumentTitleStyle
Styling for the visible document title.
colorsCopy Link
PdfColors
Override PDF colours. Any missing values fall back to the current theme.
skipGridStylesCopy Link
boolean
default: false
Set to true to skip applying grid style definitions and callbacks (rowStyle, getRowStyle, colDef.cellStyle, colDef.headerStyle). Use this when you want to rely only on colors and theme defaults.
processStyleCallbackCopy Link
Function
Callback that allows overriding styles for rows, cells, row groups, headers and group headers during PDF export. Returned styles are merged after resolved grid styles and take precedence.
processCellHyperlinkCallbackCopy Link
Function
Callback that provides an external URI for an exported body cell. The returned URI is added to the PDF as a clickable link annotation.
PdfPageSetup
Page size, orientation and margins.
fontSizeCopy Link
number
default: 10
Base font size for body rows in points.
headerFontSizeCopy Link
number
default: 11
Base font size for header rows in points.
fontFamilyCopy Link
PdfFontFamily
default: 'Helvetica'
Base font family for body rows.
headerFontFamilyCopy Link
PdfFontFamily
default: derived bold variant of `fontFamily`
Font family for header rows.
cellPaddingCopy Link
number
default: 4
Padding inside each cell in points.
columnWidthCopy Link
PdfColumnWidth | PdfColumnWidthCallback
Controls exported column widths. Use auto to size from exported content, grid to use the current grid width, a number for a width in points, or a callback for per-column control. Widths are proportionally reduced when their total exceeds the printable page width. By default, current grid widths are used except for the Row Numbers column, which is sized from its exported content.
wrapTextCopy Link
boolean
default: false
Whether table cell text should wrap onto multiple lines. This can be overridden for individual rows or cells with PdfCellStyle.wrapText.
lineHeightCopy Link
number
default: fontSize
Default distance between text baselines in points.
maxLinesCopy Link
number
Default maximum number of rendered text lines.
overflowCopy Link
PdfTextOverflow
default: 'ellipsis'
Default policy for text exceeding width, height or line limits.
rowGroupIndentSizeCopy Link
number
default: 12
Horizontal indentation in points for each row-group level.
rowHeightCopy Link
number
Height of body rows in points. If omitted, calculated from font size and padding.
headerRowHeightCopy Link
number
Height of header rows in points. If omitted, calculated from header font size and padding.
repeatHeaderCopy Link
boolean
default: true
Set to false to avoid repeating header rows on each page.
drawCellBordersCopy Link
boolean
default: true
Set to false to skip drawing cell borders.
prependContentCopy Link
PdfCustomContent
Content to put at the top of the exported sheet.
appendContentCopy Link
PdfCustomContent
Content to put at the bottom of the exported sheet.
getCustomContentBelowRowCopy Link
Function
A callback function to return content to be inserted below a row in the export.
exportRowNumbersCopy Link
boolean
Set to true to allow the contents of the Row Numbers column to be exported.
fileNameCopy Link
string | ExportFileNameGetter
default: 'export.pdf'
String to use as the file name or a function that returns a string.
mimeTypeCopy Link
string
default: 'application/pdf'
The mimeType of the PDF file.
allColumnsCopy Link
boolean
default: false
If true, all columns will be exported in the order they appear in the columnDefs. When false only the columns currently being displayed will be exported.
columnKeysCopy Link
(string | Column)[]
Provide a list (an array) of column keys or Column objects if you want to export specific columns.
rowPositionsCopy Link
RowPosition[]
Row node positions.
exportedRowsCopy Link
'all' | 'filteredAndSorted'
default: 'filteredAndSorted'
Determines whether rows are exported before being filtered and sorted.
onlySelectedCopy Link
boolean
default: false
Export only selected rows.
onlySelectedAllPagesCopy Link
boolean
default: false
Only export selected rows including other pages (only makes sense when using pagination).
skipColumnGroupHeadersCopy Link
boolean
default: false
Set to true to exclude header column groups.
skipColumnHeadersCopy Link
boolean
default: false
Set to true if you don't want to export column headers.
skipRowGroupsCopy Link
boolean
default: false
Set to true to skip row group headers if grouping rows. Only relevant when grouping rows.
skipPinnedTopCopy Link
boolean
default: false
Set to true to suppress exporting rows pinned to the top of the grid.
skipPinnedBottomCopy Link
boolean
default: false
Set to true to suppress exporting rows pinned to the bottom of the grid.
skipPinnedRowDuplicatesCopy Link
boolean
default: false
Set to true to omit the body copies of manually pinned rows. The rows in the pinned sections are still exported unless skipPinnedTop or skipPinnedBottom is enabled.
valueFromCopy Link
CellValueResolveFrom
default: 'data'
The base source to use for getting cell values.
  • 'data': values from the underlying row data
  • 'batch': pending batch edit values (falls back to data if not in batch mode)
  • 'edit': current editor values including live typing
  • transformValuesCopy Link
    boolean
    default: true
    Apply the Show Values As transform (e.g. a percentage of a total) on top of the valueFrom base, so the export carries the displayed value for columns with an active mode. Columns without one export the base value.
    shouldRowBeSkippedCopy Link
    Function
    A callback function that will be invoked once per row in the grid. Return true to omit the row from the export.
    processCellCallbackCopy Link
    Function
    A callback function invoked once per cell in the grid. Return a string value to be displayed in the export. For example this is useful for formatting date values.
    processHeaderCallbackCopy Link
    Function
    A callback function invoked once per column. Return a string to be displayed in the column header.
    processGroupHeaderCallbackCopy Link
    Function
    A callback function invoked once per column group. Return a string to be displayed in the column group header. Note that column groups are exported by default, this option will not work with skipColumnGroupHeaders=true.
    processRowGroupCallbackCopy Link
    Function
    A callback function invoked once per row group. Return a string to be displayed in the group cell.

    PdfColors Copy Link

    Properties available on the PdfColors interface.

    backgroundColorCopy Link
    string
    Background colour for the PDF page. Defaults to the theme backgroundColor.
    dataBackgroundColorCopy Link
    string
    Background colour for body rows. Defaults to the theme dataBackgroundColor.
    oddRowBackgroundColorCopy Link
    string
    Alternate background colour for odd body rows. Defaults to the theme oddRowBackgroundColor.
    foregroundColorCopy Link
    string
    Text colour for body rows. Defaults to the theme foregroundColor.
    headerBackgroundColorCopy Link
    string
    Background colour for header rows. Defaults to the theme headerBackgroundColor.
    headerTextColorCopy Link
    string
    Text colour for header rows. Defaults to the theme headerTextColor.
    borderColorCopy Link
    string
    Border colour for cell outlines. Defaults to the theme borderColor.

    PdfCellStyle Copy Link

    Properties available on the PdfCellStyle interface.

    fontSizeCopy Link
    number
    Font size in points.
    fontFamilyCopy Link
    PdfFontFamily
    Font family.
    fontWeightCopy Link
    PdfFontWeight
    Font weight. When omitted, the weight from the resolved font family is preserved.
    string
    Text colour.
    backgroundColorCopy Link
    string
    Background colour.
    borderColorCopy Link
    string
    Border colour.
    borderWidthCopy Link
    number
    Border width in points. Defaults to 1 when borderColor is set, otherwise 0.
    paddingCopy Link
    number | PdfMargin
    Padding inside the cell in points. A number applies to all sides.
    alignmentCopy Link
    PdfTextAlignment
    Horizontal alignment for the cell text.
    wrapTextCopy Link
    boolean
    Whether text should wrap onto multiple lines. Wrapped content increases the row height as required.
    preserveLineBreaksCopy Link
    boolean
    default: true when wrapText is true, otherwise false
    Whether explicit line breaks should be preserved.
    preserveSpacesCopy Link
    boolean
    default: false
    Whether repeated, leading and trailing spaces should be preserved when text wraps.
    lineHeightCopy Link
    number
    default: fontSize
    Distance between text baselines in points.
    maxLinesCopy Link
    number
    Maximum number of rendered text lines.
    overflowCopy Link
    PdfTextOverflow
    default: 'ellipsis'
    How text exceeding the available width, height or line limit is indicated.

    PdfDocumentTitleStyle Copy Link

    Properties available on the PdfDocumentTitleStyle interface.

    marginCopy Link
    number | PdfMargin
    Margin around the document title in points. A number applies to all sides.
    fontSizeCopy Link
    number
    Font size in points.
    fontFamilyCopy Link
    PdfFontFamily
    Font family.
    fontWeightCopy Link
    PdfFontWeight
    Font weight. When omitted, the weight from the resolved font family is preserved.
    string
    Text colour.
    backgroundColorCopy Link
    string
    Background colour.
    borderColorCopy Link
    string
    Border colour.
    borderWidthCopy Link
    number
    Border width in points. Defaults to 1 when borderColor is set, otherwise 0.
    paddingCopy Link
    number | PdfMargin
    Padding inside the cell in points. A number applies to all sides.
    alignmentCopy Link
    PdfTextAlignment
    Horizontal alignment for the cell text.
    wrapTextCopy Link
    boolean
    Whether text should wrap onto multiple lines. Wrapped content increases the row height as required.
    preserveLineBreaksCopy Link
    boolean
    default: true when wrapText is true, otherwise false
    Whether explicit line breaks should be preserved.
    preserveSpacesCopy Link
    boolean
    default: false
    Whether repeated, leading and trailing spaces should be preserved when text wraps.
    lineHeightCopy Link
    number
    default: fontSize
    Distance between text baselines in points.
    maxLinesCopy Link
    number
    Maximum number of rendered text lines.
    overflowCopy Link
    PdfTextOverflow
    default: 'ellipsis'
    How text exceeding the available width, height or line limit is indicated.

    PdfPageSetup Copy Link

    Properties available on the PdfPageSetup interface.

    PdfPageSize
    default: 'A4'
    The size of the PDF page.
    orientationCopy Link
    PdfPageOrientation
    default: 'landscape'
    Page orientation.
    marginCopy Link
    number | PdfMargin
    default: 36
    Page margins in points. A number applies to all sides.

    PdfCell Copy Link

    Properties available on the PdfCell interface.

    data requiredCopy Link
    PdfCellData
    The data that will be added to the cell.
    mergeAcrossCopy Link
    number
    default: 0
    The number of cells to span across (1 means span 2 columns).
    PdfCellStyle
    Optional styling for the cell.

    PdfCellData Copy Link

    Properties available on the PdfCellData interface.

    value requiredCopy Link
    string | null
    The value of the cell.
    string
    External URI opened when the exported cell text is selected.

    PdfRowStyleCallbackParams Copy Link

    Properties available on the PdfRowStyleCallbackParams<TData = any, TContext = any> interface.

    'row'
    The exported element type currently being styled.
    The row node for the exported row.
    accumulatedRowIndexCopy Link
    number
    1-based index of the current exported row.
    any
    The current value for the exported element.
    The grid api.
    Application context as set on gridOptions.context.

    PdfCellStyleCallbackParams Copy Link

    Properties available on the PdfCellStyleCallbackParams<TData = any, TContext = any> interface.

    'cell' | 'rowgroup'
    The exported element type currently being styled.
    The row node for the exported cell.
    The current column.
    accumulatedRowIndexCopy Link
    number
    1-based index of the current exported row.
    any
    The current value for the exported element.
    The grid api.
    Application context as set on gridOptions.context.

    PdfCellHyperlinkCallbackParams Copy Link

    Properties available on the PdfCellHyperlinkCallbackParams<TData = any, TContext = any> interface.

    string
    The final text exported for the cell.
    accumulatedRowIndexCopy Link
    number
    The 1-based index of the current exported row.
    The row node for the exported cell.
    The current column.
    The grid api.
    Application context as set on gridOptions.context.

    PdfHeaderStyleCallbackParams Copy Link

    Properties available on the PdfHeaderStyleCallbackParams<TData = any, TContext = any> interface.

    'header'
    The exported element type currently being styled.
    The current column.
    accumulatedRowIndexCopy Link
    number
    1-based index of the current exported row.
    any
    The current value for the exported element.
    The grid api.
    Application context as set on gridOptions.context.

    PdfGroupHeaderStyleCallbackParams Copy Link

    Properties available on the PdfGroupHeaderStyleCallbackParams<TData = any, TContext = any> interface.

    'groupheader'
    The exported element type currently being styled.
    The current column group.
    accumulatedRowIndexCopy Link
    number
    1-based index of the current exported row.
    any
    The current value for the exported element.
    The grid api.
    Application context as set on gridOptions.context.

    ColumnWidthCallbackParams Copy Link

    Properties available on the ColumnWidthCallbackParams interface.

    Column | null
    number
    number

    PdfMargin Copy Link

    Properties available on the PdfMargin interface.

    number
    Top margin in points.
    number
    Right margin in points.
    bottomCopy Link
    number
    Bottom margin in points.
    number
    Left margin in points.

    Types Copy Link

    PdfCustomContent Copy Link

    
    type PdfCustomContent = PdfCell[][] | string

    PdfPageOrientation Copy Link

    
    type PdfPageOrientation = 
          'portrait' 
        | 'landscape'

    PdfPageSize Copy Link

    
    type PdfPageSize = 
          'A4' 
        | 'Letter' 
        | { width: number; height: number; }

    PdfFontFamily Copy Link

    
    type PdfFontFamily = 
          'Helvetica' 
        | 'Helvetica-Bold' 
        | 'Times-Roman' 
        | 'Times-Bold' 
        | 'Courier' 
        | 'Courier-Bold'

    PdfTextAlignment Copy Link

    
    type PdfTextAlignment = 
          'left' 
        | 'center' 
        | 'right'

    PdfFontWeight Copy Link

    
    type PdfFontWeight = 'normal' | 'bold'

    PdfTextOverflow Copy Link

    
    type PdfTextOverflow = 'clip' | 'ellipsis'

    PdfColumnWidth Copy Link

    
    type PdfColumnWidth = 
          number 
        | 'auto' 
        | 'grid'

    PdfColumnWidthCallback Copy Link

    
    type PdfColumnWidthCallback = 
          (params: ColumnWidthCallbackParams) => PdfColumnWidth 
        | null 
        | undefined

    PdfStyleCallbackParams Copy Link

    
    type PdfStyleCallbackParams = 
          PdfRowStyleCallbackParams<TData, TContext> 
        | PdfCellStyleCallbackParams<TData, TContext> 
        | PdfHeaderStyleCallbackParams<TData, TContext> 
        | PdfGroupHeaderStyleCallbackParams<TData, TContext>

    PdfStyleCallbackType Copy Link

    
    type PdfStyleCallbackType = 
          'cell' 
        | 'row' 
        | 'rowgroup' 
        | 'header' 
        | 'groupheader'