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