---
layout: docs
title: Table Print
description: Table Print extension of Bootstrap Table.
group: extensions
toc: true
---

Adds a button to the toolbar for printing the table in a predefined configurable format.

## Usage

{% highlight html %}
<script src="extensions/print/bootstrap-table-print.js"></script>
{% endhighlight %}

## Example

[Print](https://examples.bootstrap-table.com/#extensions/print.html)

## Options

### showPrint

- **attribute:** `data-show-print`

- **type:** `Boolean`

- **Detail:**

   Set true to show the Print button on the toolbar.

- **Default:** `false`

### printAsFilteredAndSortedOnUI

- **attribute:** `data-print-as-filtered-and-sorted-on-ui`

- **type:** `Boolean`

- **Detail:**

   When true - print table as sorted and filtered on UI. Please note that if true is set, along with explicit predefined print options for filtering and sorting (printFilter, printSortOrder, printSortColumn)- then they will be applied on data already filtered and sorted by UI controls. For printing data as filtered and sorted on UI - do not set these 3 options: printFilter, printSortOrder, printSortColumn

- **Default:** `true`

### printSortColumn

- **attribute:** `data-print-sort-column`

- **type:** `String`

- **Detail:**

   set column field name to sort by for the printed table

- **Default:** `undefined`

### printSortOrder

- **attribute:** `data-print-sort-order`

- **type:** `String`

- **Detail:**

   Valid values: 'asc', 'desc'. Relevant only if printSortColumn is set

- **Default:** `'asc'`

### printPageBuilder

- **attribute:** `data-print-page-builder`

- **type:** `Function`

- **Detail:**

   Receive html `<table>` element as string parameter, returns html string for printing. Used for styling and adding header or footer.

- **Default:** `function(table){return printPageBuilderDefault(table)}`

## Column options

### printFilter

- **attribute:** `data-print-filter`

- **type:** `String`

- **Detail:**

   set value to filter the printed data by this column.

- **Default:** `undefined`

### printIgnore

- **attribute:** `data-print-ignore`

- **type:** `Boolean`

- **Detail:**

   set true to hide this column in the printed page.

- **Default:** `false`

### printFormatter

- **attribute:** `data-print-formatter`

- **type:** `Function`

- **Detail:**

   function(value, row, index) - returns a string. Formats the cell values for this column in the printed table. Function behaviour is similar to the 'formatter' column option

- **Default:** `undefined`

## Icons

* print: `'glyphicon-print icon-share'`
