---
title: "Customize headers and footers for PDF report/dashboard exports"
method: PUT
path: "/gdc/app/projects/{project_id}/export/pdfSettings"
tags: ["PDF-export-settings"]
---

# Customize headers and footers for PDF report/dashboard exports

`PUT /gdc/app/projects/{project_id}/export/pdfSettings`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/app/projects/{project_id}/export/pdfSettings`
- Auth: none declared

## Path parameters

- `project_id` string, required

## Request body

- PdfExportSettings
  - `pdfexportsettings` object, required
    - `dashboard` object: common settings for all PDF report exports
      - `allpages` object, required: settings applied for all pages of generated PDF
        - `footer` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
        - `header` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
      - `firstpageoverride` object: settings applied for first page of generated PDF only, overrides allPages settings for first page
        - `footer` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
        - `header` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
    - `report` object: common settings for all PDF report exports, NOT USED NOW !
      - `allpages` object, required: settings applied for all pages of generated PDF
        - `footer` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
        - `header` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
      - `firstpageoverride` object: settings applied for first page of generated PDF only, overrides allPages settings for first page
        - `footer` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)
        - `header` object: in all contents is valid to use predefined macros
          - `center` string: content of center box (centred)
          - `left` string: content of left box (aligned left)
          - `right` string: content of right box (aligned right)

## Response `204`

_

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)