How to set custom parameters in Bubble

In Bubble, you set custom parameters by creating custom states, URL parameters, or API call parameters. Bubble does not have a feature literally named “custom parameters,” so the correct approach depends on what you need: storing temporary values, passing values between pages, or sending data to an API.

Custom States (temporary page/app parameters)

Use these when you want to store a value temporarily on an element or page and use it in workflows.

• Select an element → in the Property Editor click Add a custom state.
• Give it a name like selected_user or filter_text.
• Choose a type (text, number, User, etc.).
• Set the state using the workflow action Element Actions → Set state.

// Example
// In a workflow: Set state
Element: Page index
Custom state: filter_text
Value: Input Search's value

URL Parameters (for passing values between pages)

Use these when you navigate from one page to another and need to pass some value in the URL.

• Use the workflow action Go to page.
• Under Send more parameters to the page, add a key and a value.
• To read the value on another page, use Get data from page URL.

// Example
Key: product_id
Value: Current cell's Product's unique id

API Connector Parameters (for external APIs)

When creating an API call in the API Connector, any dynamic value you define becomes a “parameter.” Add them in the API body, query string, or headers.

• Add an API call → insert dynamic values using key = value fields.
• Bubble automatically turns them into fields you fill when running the call.

// Example inside API body (JSON)
{
  "email": "<email>",
  "amount": "<amount>"
}
// <email> and <amount> become parameters in Bubble

Backend Workflows (API Workflow parameters)

When you create a backend workflow, you define the “parameters” the workflow receives.

• Create a new API workflow → add keys in the “Add a parameter” section.
• Those parameters become available as “This API Workflow’s parameter\_name.”

// Example parameter
Parameter name: user_id
Type: text

These are all the valid ways Bubble lets you set custom-like parameters, depending on the context.