> For the complete documentation index, see [llms.txt](https://docs.simplebooth.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplebooth.com/ai-effects/post-capture-ai-effects/guest-inputs.md).

# Guest Inputs

Guest Inputs allow participants to influence how their photo is generated. When enabled, participants are prompted to answer questions immediately after capture and before the AI image is processed.

For example, you can let guests choose a theme, pick a color, or enter custom text to be incorporated into the final result. While many effects in the [**AI Effects library**](https://app.simplebooth.com/ai-effects) come with built-in inputs, users on **Pro and Select plans** can also create their own custom input questions and parameters.

***

#### How it Works

To use Guest Inputs, you follow a three-step logic:

1. **Create the input** (The question the guest sees).
2. **Define the placeholder** (The "variable" name the computer uses).
3. **Add the placeholder to your prompt** (Linking the guest's choice to the AI).

You can add multiple guest inputs to a single prompt to create highly personalized results.

<figure><img src="/files/owLINdKYqdMyK5I9zvnS" alt="" width="563"><figcaption></figcaption></figure>

***

{% stepper %}
{% step %}

#### Create the Input

From the **Guest Input Settings** section of your [AI Effect](https://app.simplebooth.com/ai-effects):

1. Select the **+** button.
2. Select a **Prompt Type**:
   * **Text:** Guests type a custom response (e.g., "Enter your name").
   * **Picker:** Guests choose from a list you provide (e.g., "Choose a background: Jungle, Space, or Ocean").
3. Enter the **Question** participants will see on the screen.
   {% endstep %}

{% step %}

#### Define the Placeholder

Every input needs a "Placeholder" or variable name. This acts as a shortcut for the app to know where to insert the guest's answer.

1. In the **Prompt Placeholder** field, enter a simple, one-word name (e.g., `theme` or `color`).
2. If using a **Text** prompt, add an example value to guide guests.
3. If using a **Picker** prompt, add the selectable options you want guests to see.
4. Save and close.
   {% endstep %}

{% step %}

#### Link the Input to Your Prompt

The guest's choice won't affect the photo until you "summon" it inside your AI Prompt.

1. Return to your **Prompt Settings**.
2. In the prompt text box, type your variable name surrounded by double braces: `{{theme}}`.
   * *Example: "A person standing in a {{theme}} environment."*
3. Alternatively, you can select the placeholder name from the list displayed beneath the prompt field to insert it automatically.
   {% endstep %}
   {% endstepper %}

***

{% hint style="success" %}

## Plan Availability

**Write Custom Guest Inputs**

:white\_check\_mark: Pro, Select

:x: Lite, Core, Plus
{% endhint %}


---

# 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.simplebooth.com/ai-effects/post-capture-ai-effects/guest-inputs.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.