# App Install Banner

<figure><img src="/files/OIVLD365pDyhsVb85Uxv" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">How It Works</mark>

Once enabled, the banner appears for website visitors based on your targeting and timing settings.\
You can fully customize its text, design, placement, and visibility.

### <mark style="color:green;">Configuration Options</mark>

#### **Placement**

Choose where the banner appears:

* **Top** *(default)*
* **Bottom**<br>

![](/files/GThgTBncBQPZuAIwURTc)![](/files/5SlfJ1A9vzrtCXOCxVUX)

#### **Background Color**

* Defaults to your theme background
* Fully customizable using a color picker

#### **Title**

* Max **40 characters**
* Supports styling (Label Large by default)
* Editable color

#### **Description**

* Max **100 characters**
* Uses Body Small style by default
* Editable color

#### **CTA Button**

* Max **20 characters**
* Supports native-style button designs

#### **Page Targeting**

Control where the banner is shown:

* **All Pages** *(default)*
* **Specific Pages**
  * Accepts URL expressions (e.g., `/products/*`)

#### **Device Targeting**

Choose which users should see the banner:

* **Mobile only**
* **Desktop only**
* **Both** *(default)*

#### **Trigger Delay**

When the banner should appear:

* **Immediately** *(default)*
* **After X seconds** (e.g., enter `60` for 1 minute)

#### **Display Frequency**

Set how often the banner reappears after dismissal:

* Accepts **minutes, hours, or days**
* Default: **24 hours**

***


---

# Agent Instructions: 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:

```
GET https://help.twinr.dev/app-marketing-widget/app-install-banner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
