# OrganizationListView

![The OrganizationListView renders a standalone account picker for choosing between the user's Personal Account and Organization accounts.](https://clerk.com/docs/raw/_public/images/ui-components/android-organization-list-view.png){{ style: { maxWidth: '427px' } }}

The `OrganizationListView` renders a standalone account picker for choosing between the user's Personal Account and Organization accounts. It lists the Personal Account when allowed, Organization memberships, pending Organization invitations, suggested Organizations, and a **Create organization** action for users who can create Organizations.

Personal Account selection clears the Active Organization. Organization selection sets the selected Organization as **active**.

## Parameters

| Name                     | Type                                       | Description                                                                                                                                                                                                                                                                                                                     |
| ------------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| modifier                 | Modifier                                   | A modifier that gets applied to OrganizationListView.                                                                                                                                                                                                                                                                           |
| clerkTheme               | ClerkTheme?                                | The theme to apply to the OrganizationListView.                                                                                                                                                                                                                                                                                 |
| hidePersonalAccount      | Boolean                                    | Whether the Personal AccountPersonal Accounts are individual workspaces that allow users to operate independently without belonging to an Organization. Learn more about Personal Accounts. option should be hidden even when the option is allowed. Defaults to false.                                                         |
| isDismissable            | Boolean                                    | Whether the view can be dismissed by the user. When true, a dismiss button appears and the view closes automatically after account selection. When false, no dismiss button is shown. Defaults to true.                                                                                                                         |
| skipPostCreateInviteFlow | Boolean                                    | Reserved for create Organization flows that include a post-create invitation step. Android's current flow already stops after creation. Defaults to false.                                                                                                                                                                      |
| onDismissRequest         | (() -> Unit)?                              | Called when the dismiss affordance is pressed or when a dismissable selection completes.                                                                                                                                                                                                                                        |
| onCreateOrganization     | ((OrganizationCreationDefaults?) -> Unit)? | Called when the user selects the Create Organization action. The latest creation defaults are provided when available.                                                                                                                                                                                                          |
| onAccountSelected        | ((String?) -> Unit)?                       | Called after selecting the Personal AccountPersonal Accounts are individual workspaces that allow users to operate independently without belonging to an Organization. Learn more about Personal Accounts. or an Organization. Receives null for Personal Account selection and the Organization ID for Organization selection. |

## Usage

The following examples show how to use the `OrganizationListView` in your app.

### Fullscreen account picker

```kotlin
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import com.clerk.ui.organizationlist.OrganizationListView

@Composable
fun AccountPickerScreen(onDone: () -> Unit) {
    OrganizationListView(
        modifier = Modifier.fillMaxSize(),
        onDismissRequest = onDone,
        onAccountSelected = { selectedOrganizationId ->
            // selectedOrganizationId is null when the user selects their Personal Account.
            onDone()
        },
    )
}
```

### Custom create Organization flow

```kotlin
import com.clerk.api.organizations.OrganizationCreationDefaults
import com.clerk.ui.organizationlist.OrganizationListView

OrganizationListView(
    onCreateOrganization = { creationDefaults: OrganizationCreationDefaults? ->
        // Navigate to your own create Organization flow.
    },
)
```

### Hide the Personal Account option

```kotlin
OrganizationListView(
    hidePersonalAccount = true,
    onAccountSelected = { organizationId ->
        // organizationId is non-null when Personal Account option is hidden.
    },
)
```

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)
