> For the complete documentation index, see [llms.txt](https://docs.pixiebrix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixiebrix.com/developing-mods/developer-concepts/types-of-mods/button/floating-actions.md).

# Floating Actions

Users can initiate mods with buttons from the PixieBrix Floating Action Button. These are great for launching frequently used mods or utilities.

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

### How to Create a Floating Action

1. **Add a Trigger Starter brick**

Use the [**Trigger**](/developing-mods/developer-concepts/types-of-mods/trigger.md) starter brick with a **Page Load** trigger event to register the Floating Action when a page loads.

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

2. **Add the Floating Action Brick**

Click the **+** button in the Brick Action Pipeline to add the **Add Floating Action** brick.

3. **Configure the Floating Action**

In the Add Floating Action brick:

* **Title**:  This appears as a tooltip when hovering over the icon.
* **Action Type**: Choose static or dynamic actions. (See explanation [below](#static-vs-dyanmic-actions).)
* **Icon**: Pick one from the dropdown or use a custom icon by pasting a URL to an SVG.&#x20;
* **Priority**: Determines the display order if multiple actions exist. Higher numbers show higher in the list.

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

4. Add Your Action Logic

Within the Floating Action’s pipeline, add any bricks you want to run when a user clicks the action.

### Static vs Dynamic Actions

<table><thead><tr><th width="177.03125">Type</th><th width="255.23828125">When to use</th><th>Example Use</th></tr></thead><tbody><tr><td>Static</td><td>For global actions that should always be available </td><td>"Start recording" button</td></tr><tr><td>Dynamic</td><td>For temporary or context-specific controls</td><td>"Pause" or "Stop" buttons during a recording action</td></tr></tbody></table>

{% hint style="danger" %}
Note: If any dynamic actions are registered, static actions will not be shown.&#x20;
{% endhint %}

### FAQs

**What happens if I register both static and dynamic actions?**

Only dynamic actions will be shown. Static actions are hidden whenever dynamic ones are active.<br>

**Where does the Floating Action appear?**

It appears as a button overlay in the corner of the page (usually center right) with the PixieBrix icon or your team's custom icon.<br>

**Can I have multiple Floating Actions?**

Yes. Use the priority setting to control their order.<br>

**Can I style the Floating Action icon?**

You can use a custom SVG icon via URL, which allows full control over the look.


---

# 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.pixiebrix.com/developing-mods/developer-concepts/types-of-mods/button/floating-actions.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.
