> For the complete documentation index, see [llms.txt](https://docs.planetstyles.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetstyles.net/feature-guides/milk-theme/milk-forum-list-options.md).

# Milk: Forum list options

There are 3 forum list display options in Milk. 

### Forum list options

| Option name                                                                                                        | Output                                                              |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| <p><strong>List</strong><br><br>Traditional forumlist</p>                                                          | <img src="/files/QsEgOFfQN5bN3tLbYV3J" alt="" data-size="original"> |
| <p><strong>List (Simplified)</strong><br><br>List with 'topics' column removed and double-width 'posts' column</p> | <img src="/files/iezR80TcXgbMDgIpYxVP" alt="" data-size="original"> |
| <p><strong>Grid</strong><br><br>Forum tiles with an assigned icon or background image</p>                          | <img src="/files/AtLfMsPTQ5GffcTFTxiS" alt="" data-size="original"> |

### Changing the forumlist display

1. Open the FlightDeck extension (control panel)
2. Find "Forumlist Display"
3. Set as required
4. Submit

***

### Assigning images to grid tiles

You can assign an icon or image background to a grid tile by using phpBB's native "forum image" feature.

1. Using a file manager, upload the image(s) you want to use to the following location: `yourforum.com/images/grid/`\
   (You will probably need to create the new folder called "grid")
2. Navigate to: ACP (Admin Control Panel) → "Forums" (tab)
3. In the left sidebar, click "Manage forums"
4. Next to the forum you want to add the image to, click the green "Settings" icon&#x20;

   <div align="left"><img src="https://web.archive.org/web/20230604080211im_/https://d33v4339jhl8k0.cloudfront.net/docs/assets/5e36e5442c7d3a7e9ae71c84/images/5e9c59eb2c7d3a7e9aeb369a/file-v24pjoaHC8.gif" alt=""></div>
5. In the "Forum image" field, type the full path to the image you want to use.

The path is relative to your phpBB installation, so you don't need to include the domain name in the image path. For example: If your image is located in

`yourforum.com/images/grid/forum_1_background.jpg` , you only need to enter: `images/grid/forum_1_background.jpg`

***

### Using a full-size grid tile background

There are 2 display options for grid forum images:

| Option name                                | Value | Output                                                              |
| ------------------------------------------ | ----- | ------------------------------------------------------------------- |
| **Fill grid tiles with background image?** | Yes   | <img src="/files/9lG55Z8qLexyRzN9Vc03" alt="" data-size="original"> |
|                                            | No    | <img src="/files/JNwysdMdloW70SAuiLnY" alt="" data-size="original"> |

This option can be enabled in the FlightDeck extension, directly below the "Forumlist display" option.

***

### Responsive layout information

* When the list or list (simplified) option is selected, a dedicated responsive view will load for users browsing on small devices. This doesn't affect the grid template, as this automatically scales
* When the list or list (simplified) option is selected, the 'topics' column will be hidden on narrow tablets such as iPads in portrait orientation


---

# 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.planetstyles.net/feature-guides/milk-theme/milk-forum-list-options.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.