> For the complete documentation index, see [llms.txt](https://docs.lufavo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lufavo.com/roomfolk/sections/image-banner.md).

# Image banner

A wide image with text over it — for a campaign, a season, or a link into a collection.

## Set it up

1. Add the section.
2. Upload an **Image**.
3. Add blocks for whatever goes on top: a heading, some text, a button.

## Image

| Setting         | What it does                                                 |
| --------------- | ------------------------------------------------------------ |
| Image           | The banner image.                                            |
| Mobile image    | Optional. A tighter crop for narrow screens.                 |
| Height          | Small, Medium or Large.                                      |
| Overlay opacity | 0% to 80%. Darkens the image so text over it stays readable. |

**On the mobile image:** a wide banner cropped to a phone screen often loses its subject — the thing you photographed ends up outside the frame. Upload a tighter crop here if that happens. If you leave it empty, the main image is used.

**On overlay opacity:** raise it until your text is comfortable to read. A busy photograph usually needs 40% or more. A plain one may need none.

## Content

The text is built from blocks, so you choose what goes on the banner. Add a heading, a line of text, a button, or any other [general block](/roomfolk/blocks/general-blocks.md).

| Setting          | What it does                                     |
| ---------------- | ------------------------------------------------ |
| Content position | Left, Center or Right.                           |
| Alignment        | How the text itself is aligned within that area. |

## Style

| Setting      | What it does                                         |
| ------------ | ---------------------------------------------------- |
| Color scheme | Which scheme the section uses. Defaults to scheme 3. |

It defaults to a dark scheme because text usually sits over a photograph here. The overlay is drawn in the scheme's own background color, so a light scheme lightens the image and a dark one darkens it — either way the text keeps its contrast.


---

# 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.lufavo.com/roomfolk/sections/image-banner.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.