---
title: "Excel Export - Styles"
enterprise: true
framework: angular
version: "36.1.0"
---

# Excel Export - Styles

Excel Export provides a special mechanism to add styles to the exported spreadsheet that works independently of the styles applied to the grid.

## Defining styles

The main reason to export to Excel with styles is so that the look and feel remain as consistent as possible with your AG Grid application. In order to simplify the configuration, the Excel Export reuses the [cellClassRules](https://www.ag-grid.com/angular-data-grid/cell-styles/#cell-class-rules), the [cellClass](https://www.ag-grid.com/angular-data-grid/cell-styles/#cell-class) and the [headerClass](https://www.ag-grid.com/angular-data-grid/column-properties/#reference-header-headerClass) from the column definition. Whatever resultant class is applicable to the cell then is expected to be provided as an Excel Style to the `excelStyles`: [ExcelStyle[]](https://www.ag-grid.com/angular-data-grid/excel-export-api/#excelstyle) property in the [gridOptions](https://www.ag-grid.com/angular-data-grid/grid-options/).

## Resolving Excel Styles

All the defined classes from [cellClass](https://www.ag-grid.com/angular-data-grid/cell-styles/#cell-class) and all the classes resulting from evaluating the [cellClassRules](https://www.ag-grid.com/angular-data-grid/cell-styles/#cell-class-rules) are applied to each cell, while the resulting classes from [headerClass](https://www.ag-grid.com/angular-data-grid/column-properties/#reference-header-headerClass) will be applied to each header cell when exporting to Excel. Normally these styles map to CSS classes when the grid is doing normal rendering. In Excel Export, the styles are mapped against the Excel styles that you have provided. If more than one Excel style is found, the results are merged (similar to how CSS classes are merged by the browser when multiple classes are applied).

## Excel Style Definition Example

The example below demonstrates how to merge the styles in Excel. Everyone less than 23 will have a green background, and a light green color font (`#e0ffc1`) also because redFont is set in cellClass, it will always be applied.

> **Note**
>
> The ExcelStyle id `cell` is applied to every cell that is **not** a header, and it's useful if you need a style to be applied to all cells.

```ts
<ag-grid-angular
    [columnDefs]="columnDefs"
    [excelStyles]="excelStyles"
    /* other grid options ... */ />

this.columnDefs = [
    {
        // The same cellClassRules and cellClass can be used for CSS and Excel
        cellClassRules: {
            greenBackground: params => params.value < 23,
        },
        cellClass: 'redFont'
    }
];
this.excelStyles = [
    // The base style, red font.
    {
        id: "redFont",
        font: {
            color: '#ff0000',
        },
    },
    // The cellClassStyle: background is green and font color is light green,
    // note that since this excel style it's defined after redFont
    // it will override the red font color obtained through cellClass:'red'
    {
        id: "greenBackground",
        alignment: {
            horizontal: 'Right', vertical: 'Bottom'
        },
        font: { color: "#e0ffc1"},
        interior: {
            color: "#008000", pattern: 'Solid'
        }
    },
    {
        id: "cell",
        alignment: {
            vertical: "Center"
        }
    }
];
```

## Example: Export With Styles

Note the following:

- An Excel Style with id `cell` gets automatically applied to all cells (**not headers**) when exported to Excel.
- All cells will be vertically aligned to the middle due to Excel Style id `cell`.
- Styles can be combined in a similar fashion to CSS, this can be seen in the column **age** where athletes less than 20 years old get two styles applied (greenBackground and redFont).
- A default columnDef containing cellClassRules can be specified and it will be exported to Excel. You can see this is in the styling of the `darkGreyBackground` being applied to `even` rows.
- If a cell has a style but there isn't an associated Excel Style defined, the style for that cell won't get exported. This is the case in this example of the year column which has the style notInExcel, but since it hasn't been specified in the gridOptions, the column then gets exported without formatting.
- As you can see in the column **Group**, the Excel styles can be combined into cellClassRules and cellClass
- Note that there are specific to Excel styles applied - the age column has a conditional number formatting styling applied: age values less than `23` have a green background applied, and age values less than `20` are using red italic underlined font.

#### Excel Export - Styles

```ts
import { Component } from "@angular/core";
import { HttpClient } from "@angular/common/http";
import { AgGridAngular } from "ag-grid-angular";
import "./styles.css";
import {
  CellClassParams,
  CellStyleModule,
  ClientSideRowModelModule,
  ColDef,
  ColGroupDef,
  ExcelStyle,
  GridApi,
  GridOptions,
  GridReadyEvent,
  ModuleRegistry,
  TextFilterModule,
  enableDevValidations,
} from "ag-grid-community";
import {
  ColumnMenuModule,
  ContextMenuModule,
  ExcelExportModule,
} from "ag-grid-enterprise";
if (process.env.NODE_ENV !== "production") {
  enableDevValidations();
}

ModuleRegistry.registerModules([
  TextFilterModule,
  CellStyleModule,
  ClientSideRowModelModule,
  ExcelExportModule,
  ColumnMenuModule,
  ContextMenuModule,
]);
import { IOlympicData } from "./interfaces";

@Component({
  selector: "my-app",
  standalone: true,
  imports: [AgGridAngular],
  template: `<div class="page-wrapper">
    <div>
      <button
        (click)="onBtnExportDataAsExcel()"
        style="margin-bottom: 5px; font-weight: bold"
      >
        Export to Excel
      </button>
    </div>

    <div class="grid-wrapper">
      <ag-grid-angular
        style="width: 100%; height: 100%;"
        [columnDefs]="columnDefs"
        [defaultColDef]="defaultColDef"
        [excelStyles]="excelStyles"
        [rowData]="rowData"
        (gridReady)="onGridReady($event)"
      />
    </div>
  </div> `,
})
export class AppComponent {
  private gridApi!: GridApi<IOlympicData>;

  columnDefs: ColDef[] = [
    { field: "athlete", minWidth: 200 },
    {
      field: "age",
      cellClassRules: {
        greenBackground: (params) => {
          return params.value < 23;
        },
        redFont: (params) => {
          return params.value < 20;
        },
      },
    },
    {
      field: "country",
      minWidth: 200,
      cellClassRules: {
        redFont: (params) => {
          return params.value === "United States";
        },
      },
    },
    {
      headerName: "Group",
      valueGetter: "data.country.charAt(0)",
      cellClass: ["redFont", "greenBackground"],
    },
    {
      field: "year",
      cellClassRules: {
        notInExcel: (params) => {
          return true;
        },
      },
    },
    { field: "sport", minWidth: 150 },
  ];
  defaultColDef: ColDef = {
    cellClassRules: {
      darkGreyBackground: (params: CellClassParams) => {
        return (params.node.rowIndex || 0) % 2 == 0;
      },
    },
    filter: true,
    minWidth: 100,
    flex: 1,
  };
  excelStyles: ExcelStyle[] = [
    {
      id: "cell",
      alignment: {
        vertical: "Center",
      },
    },
    {
      id: "greenBackground",
      interior: {
        color: "#b5e6b5",
        pattern: "Solid",
      },
    },
    {
      id: "redFont",
      font: {
        fontName: "Calibri Light",
        underline: "Single",
        italic: true,
        color: "#BB0000",
      },
    },
    {
      id: "darkGreyBackground",
      interior: {
        color: "#888888",
        pattern: "Solid",
      },
      font: {
        fontName: "Calibri Light",
        color: "#ffffff",
      },
    },
  ];
  rowData!: IOlympicData[];

  constructor(private http: HttpClient) {}

  onBtnExportDataAsExcel() {
    this.gridApi.exportDataAsExcel();
  }

  onGridReady(params: GridReadyEvent<IOlympicData>) {
    this.gridApi = params.api;

    this.http
      .get<
        IOlympicData[]
      >("https://www.ag-grid.com/example-assets/olympic-winners.json")
      .subscribe((data) => (this.rowData = data));
  }
}
```

[Live example: Excel Export - Styles](https://www.ag-grid.com/examples/excel-export-styles/excel-export-with-styles/angular)

## Styling Headers

Similarly to styling cells, the grid will use the result of [headerClass](https://www.ag-grid.com/angular-data-grid/column-properties/#reference-header-headerClass) from the column definition to style the grid headers.

Default Column Header Export Styles:

- An Excel Style with id `header` gets automatically applied to all (grouped and not grouped) AG Grid headers when exported to Excel.
- An Excel Style with id `headerGroup` gets automatically applied to the AG Grid grouped headers when exported to Excel.

You can define custom styles to apply to specific column headers when exported to Excel. In the example below, export to Excel and note:

- All column headers will be vertically aligned to the middle, have a grey background colour of `#f8f8f8` and an orange bottom border bottom of colour `#ffab00` due to the Excel Style id `header`.
- All grouped headers will have a bold font due to Excel Style id `headerGroup`.
- The Gold column header will have a gold-like background color.
- The Silver column header will have a silver-like background color.
- The Bronze column header will have a bronze-like background color.
- All column header rows have a height of **30px**.

#### Excel Export - Header Styles

```ts
import { Component } from "@angular/core";
import { HttpClient } from "@angular/common/http";
import { AgGridAngular } from "ag-grid-angular";
import "./styles.css";
import {
  CellClassParams,
  ClientSideRowModelModule,
  ColDef,
  ColGroupDef,
  ExcelExportParams,
  ExcelStyle,
  GridApi,
  GridOptions,
  GridReadyEvent,
  ModuleRegistry,
  NumberFilterModule,
  TextFilterModule,
  enableDevValidations,
} from "ag-grid-community";
import {
  ColumnMenuModule,
  ContextMenuModule,
  ExcelExportModule,
} from "ag-grid-enterprise";
if (process.env.NODE_ENV !== "production") {
  enableDevValidations();
}

ModuleRegistry.registerModules([
  TextFilterModule,
  NumberFilterModule,
  ClientSideRowModelModule,
  ExcelExportModule,
  ColumnMenuModule,
  ContextMenuModule,
]);
import { IOlympicData } from "./interfaces";

@Component({
  selector: "my-app",
  standalone: true,
  imports: [AgGridAngular],
  template: `<div class="page-wrapper">
    <div>
      <button
        (click)="onBtnExportDataAsExcel()"
        style="margin-bottom: 5px; font-weight: bold"
      >
        Export to Excel
      </button>
    </div>

    <div class="grid-wrapper">
      <ag-grid-angular
        style="width: 100%; height: 100%;"
        [columnDefs]="columnDefs"
        [defaultColDef]="defaultColDef"
        [defaultExcelExportParams]="defaultExcelExportParams"
        [excelStyles]="excelStyles"
        [rowData]="rowData"
        (gridReady)="onGridReady($event)"
      />
    </div>
  </div> `,
})
export class AppComponent {
  private gridApi!: GridApi<IOlympicData>;

  columnDefs: (ColDef | ColGroupDef)[] = [
    { field: "athlete" },
    { field: "sport", minWidth: 150 },
    {
      headerName: "Medals",
      children: [
        { field: "gold", headerClass: "gold-header" },
        { field: "silver", headerClass: "silver-header" },
        { field: "bronze", headerClass: "bronze-header" },
      ],
    },
  ];
  defaultColDef: ColDef = {
    filter: true,
    minWidth: 100,
    flex: 1,
  };
  defaultExcelExportParams: ExcelExportParams = {
    headerRowHeight: 30,
  };
  excelStyles: ExcelStyle[] = [
    {
      id: "header",
      alignment: {
        vertical: "Center",
      },
      interior: {
        color: "#f8f8f8",
        pattern: "Solid",
        patternColor: undefined,
      },
      borders: {
        borderBottom: {
          color: "#ffab00",
          lineStyle: "Continuous",
          weight: 1,
        },
      },
    },
    {
      id: "headerGroup",
      font: {
        bold: true,
      },
    },
    {
      id: "gold-header",
      interior: {
        color: "#E4AB11",
        pattern: "Solid",
      },
    },
    {
      id: "silver-header",
      interior: {
        color: "#bbb4bb",
        pattern: "Solid",
      },
    },
    {
      id: "bronze-header",
      interior: {
        color: "#be9088",
        pattern: "Solid",
      },
    },
  ];
  rowData!: IOlympicData[];

  constructor(private http: HttpClient) {}

  onBtnExportDataAsExcel() {
    this.gridApi.exportDataAsExcel();
  }

  onGridReady(params: GridReadyEvent<IOlympicData>) {
    this.gridApi = params.api;

    this.http
      .get<
        IOlympicData[]
      >("https://www.ag-grid.com/example-assets/olympic-winners.json")
      .subscribe((data) => (this.rowData = data));
  }
}
```

[Live example: Excel Export - Header Styles](https://www.ag-grid.com/examples/excel-export-styles/excel-export-with-header-styles/angular)

## Example: Styling Row Groups

By default, row groups are exported with the names of each node in the hierarchy combined, like "-⁠> Parent -⁠> Child". If you prefer to use indentation to indicate hierarchy like the Grid user interface does, you can achieve this by combining `autoGroupColumnDef.cellClass` and `processRowGroupCallback`:

```ts
processRowGroupCallback(params: ProcessRowGroupForExportParams): string {
    // Discard the `->` added by default, and render the original key.
    return params.node.key;
}
```

```ts
    autoGroupColumnDef: {
        cellClass: getIndentClass
        //...
    }
    excelStyles: [
        {
            id: 'indent-1',
            alignment: {
                indent: 1
            },
            // note, dataType: 'String' required to ensure that numeric values aren't right-aligned
            dataType: 'String'
        },
        //...
    ]
    //...
```

```ts
getIndentClass(params: CellClassParams): string[] | string {
    const node = params.node;

    let indent = 0;
    while (node && node.parent) {
        indent++;
        node = node.parent;
    }

    return `indent-${indent}`;
}
```

#### Excel Export - Styling Row Groups

```ts
import { Component } from "@angular/core";
import { HttpClient } from "@angular/common/http";
import { AgGridAngular } from "ag-grid-angular";
import "./style.css";
import {
  AutoGroupColumnDef,
  CellClassParams,
  CellStyleModule,
  ClientSideRowModelModule,
  ColDef,
  ColGroupDef,
  ExcelStyle,
  GridApi,
  GridOptions,
  GridReadyEvent,
  ModuleRegistry,
  NumberFilterModule,
  ProcessRowGroupForExportParams,
  TextFilterModule,
  enableDevValidations,
} from "ag-grid-community";
import {
  ColumnMenuModule,
  ContextMenuModule,
  ExcelExportModule,
  RowGroupingModule,
} from "ag-grid-enterprise";
if (process.env.NODE_ENV !== "production") {
  enableDevValidations();
}

ModuleRegistry.registerModules([
  TextFilterModule,
  NumberFilterModule,
  CellStyleModule,
  ClientSideRowModelModule,
  ExcelExportModule,
  ColumnMenuModule,
  ContextMenuModule,
  RowGroupingModule,
]);
import { IOlympicData } from "./interfaces";

@Component({
  selector: "my-app",
  standalone: true,
  imports: [AgGridAngular],
  template: `<div class="page-wrapper">
    <div>
      <button
        (click)="onBtnExportDataAsExcel()"
        style="margin-bottom: 5px; font-weight: bold"
      >
        Export to Excel
      </button>
    </div>

    <div class="grid-wrapper">
      <ag-grid-angular
        style="width: 100%; height: 100%;"
        [columnDefs]="columnDefs"
        [defaultColDef]="defaultColDef"
        [groupDefaultExpanded]="groupDefaultExpanded"
        [autoGroupColumnDef]="autoGroupColumnDef"
        [excelStyles]="excelStyles"
        [rowData]="rowData"
        (gridReady)="onGridReady($event)"
      />
    </div>
  </div> `,
})
export class AppComponent {
  private gridApi!: GridApi<IOlympicData>;

  columnDefs: ColDef[] = [
    { field: "country", minWidth: 120, rowGroup: true },
    { field: "year", rowGroup: true },
    { headerName: "Name", field: "athlete", minWidth: 150 },
    {
      headerName: "Name Length",
      valueGetter: 'data ? data.athlete.length : ""',
    },
    { field: "sport", minWidth: 120, rowGroup: true },
    { field: "silver" },
    { field: "bronze" },
    { field: "total" },
  ];
  defaultColDef: ColDef = {
    filter: true,
    minWidth: 100,
    flex: 1,
  };
  groupDefaultExpanded = -1;
  autoGroupColumnDef: AutoGroupColumnDef = {
    cellClass: getIndentClass,
    minWidth: 250,
    flex: 1,
  };
  excelStyles: ExcelStyle[] = [
    {
      id: "indent-1",
      alignment: {
        indent: 1,
      },
      // note, dataType: 'string' required to ensure that numeric values aren't right-aligned
      dataType: "String",
    },
    {
      id: "indent-2",
      alignment: {
        indent: 2,
      },
      dataType: "String",
    },
    {
      id: "indent-3",
      alignment: {
        indent: 3,
      },
      dataType: "String",
    },
  ];
  rowData!: IOlympicData[];

  constructor(private http: HttpClient) {}

  onBtnExportDataAsExcel() {
    this.gridApi.exportDataAsExcel({
      processRowGroupCallback: rowGroupCallback,
    });
  }

  onGridReady(params: GridReadyEvent<IOlympicData>) {
    this.gridApi = params.api;

    this.http
      .get<
        IOlympicData[]
      >("https://www.ag-grid.com/example-assets/olympic-winners.json")
      .subscribe((data) => {
        this.rowData = data;
      });
  }
}

function rowGroupCallback(params: ProcessRowGroupForExportParams) {
  return params.node.key!;
}
function getIndentClass(params: CellClassParams) {
  let indent = 0;
  let node = params.node;
  while (node && node.parent) {
    indent++;
    node = node.parent;
  }
  return "indent-" + indent;
}
```

[Live example: Excel Export - Styling Row Groups](https://www.ag-grid.com/examples/excel-export-styles/excel-export-styling-row-groups/angular)

## Handling Excel Style Errors

If you get an error when opening the Excel file, the most likely reason is that there is an error in the definition of the styles. If that is the case, we recommend that you remove all style definitions from your configuration and add them one-by-one until you find the definition that is causing the error.

Some of the most likely errors you can encounter when exporting to Excel are:

- Not specifying all the attributes of an Excel Style property. If you specify the interior for a Excel style and don't provide a pattern, just color, Excel will fail to open the spreadsheet
- Using invalid characters in attributes, we recommend you not to use special characters.
- Not specifying the style associated to a cell, if a cell has an style that is not passed as part of the grid options, Excel won't fail opening the spreadsheet but the column won't be formatted.
- Specifying an invalid enumerated property. It is also important to realise that Excel is case sensitive, so Solid is a valid pattern, but SOLID or solid are not.

## API

### API Methods

| Property | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `exportDataAsExcel` | `Function` |  |  | Downloads an Excel export of the grid's data. Module: [`ExcelExportModule`](https://www.ag-grid.com/angular-data-grid/modules/). |
| `getDataAsExcel` | `Function` |  |  | Similar to `exportDataAsExcel`, except instead of downloading a file, it will return a [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) to be processed by the user. Module: [`ExcelExportModule`](https://www.ag-grid.com/angular-data-grid/modules/). |

### Grid Properties

| Property | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `excelStyles` | [`ExcelStyle[]`](https://www.ag-grid.com/angular-data-grid/excel-export-api/#excelstyle) |  |  | A list (array) of Excel styles to be used when exporting to Excel with styles. Module: [`ExcelExportModule`](https://www.ag-grid.com/angular-data-grid/modules/). [Initial](https://www.ag-grid.com/angular-data-grid/grid-interface/#initial-grid-options). |