> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-data-integration/9.3-data-integration/get-started-with-the-pdi-client/customize-the-pdi-client.md).

# Customize the PDI client

The PDI client allows you to customize certain aspects of its behavior, along with the look and feel of the interface. The following table describes each of these options, which can be accessed from the menu bar: Go to **Tools** > **Options**, then in the Kettle Options dialog box, select the **Look & Feel** tab.

| **Option**                               | **Description**                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fixed width font**                     | This option customizes the font that is used in the dialog boxes, trees, input fields, and more; click **Edit** to edit the font or **Delete** to return the font to its default value.                                                                                                                                                                                                        |
| **Font on workspace**                    | This option customizes font that is used in the PDI client interface; click **Edit** to edit the font or **Delete** to return the font to its default value.                                                                                                                                                                                                                                   |
| **Font for notes**                       | This option customizes the font used in notes that are displayed in the PDI client; click **Edit** to edit the font or **Delete** to return the font to its default value.                                                                                                                                                                                                                     |
| **Background color**                     | This option sets the background color in the PDI client and affects all dialog boxes; click **Edit** to edit the color or **Delete** to return the background color to its default value.                                                                                                                                                                                                      |
| **Workspace background color**           | This option sets the background color in the graphical view of the PDI client; click **Edit** to edit the background color or **Delete** to return the background color to its default value.                                                                                                                                                                                                  |
| **Tab color**                            | This option customizes the color that is being used to indicate tabs that are active/selected; click **Edit** to edit the tab color or **Delete** to return the color to its default value.                                                                                                                                                                                                    |
| **Icon size in workspace**               | Affects the size of the icons in the graph window. The original size of an icon is 32x32 pixels. The best results (graphically) are probably at sizes 16,24,32,48,64 and other multiples of 32.                                                                                                                                                                                                |
| **Line width on workspace**              | Affects the line width of the hops in the PDI client graphical view and the border around the step.                                                                                                                                                                                                                                                                                            |
| **Shadow size on workspace**             | If this size is larger than 0, a shadow of the steps, hops, and notes is drawn on the canvas, making it look like the transformation floats above the canvas.                                                                                                                                                                                                                                  |
| **Dialog middle percentage**             | By default, a parameter is drawn at 35% of the width of the dialog box, counted from the left. You can change using this option in instances where you use unusually large fonts.                                                                                                                                                                                                              |
| **Canvas Grid Size**                     | Indicates the size of the grid on the PDI client canvas.                                                                                                                                                                                                                                                                                                                                       |
| **Show Canvas Grid**                     | Enabling this option will show a dotted grid on the PDI client canvas.                                                                                                                                                                                                                                                                                                                         |
| **Canvas anti-aliasing**                 | Some platforms like Windows, OSX and Linux support anti-aliasing through GDI, Carbon or Cairo. Enable this option for smoother lines and icons in your graph view. If you enable the option and your environment does not work, change the value for option **EnableAntiAliasing** to `N` in file `*$HOME*/.kettle/.spoonrc` (`C:\Documents and Settings\<user>\.kettle\.spoonrc` on Windows). |
| **Show bottleneck transformation steps** | If a step in the transformation is processing slowly, a graphic displays around that step to make the bottleneck visible.                                                                                                                                                                                                                                                                      |
| **Use look of OS**                       | Enabling this option on Windows allows you to use the default system settings for fonts and colors in the PDI client. On other platforms, the default is always enabled.                                                                                                                                                                                                                       |
| **Show branding graphics**               | Enabling this option will draw Pentaho Data Integration branding graphics on the canvas and in the left-hand side "expand bar."                                                                                                                                                                                                                                                                |
| **Preferred Language**                   | Specifies the preferred language setting.                                                                                                                                                                                                                                                                                                                                                      |
| **Alternative Language**                 | Specifies the alternative language setting. Because the original language in which Pentaho Data Integration was written is English, it is best to set this locale to English.                                                                                                                                                                                                                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/9.3-data-integration/get-started-with-the-pdi-client/customize-the-pdi-client.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
