> ## Documentation Index
> Fetch the complete documentation index at: https://rive.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Artboards

> Selecting which artboard to render at runtime

For more information on creating artboards in the Rive editor, please refer to [Artboards](/editor/fundamentals/artboards).

## Choosing an Artboard

When a Rive object is instantiated or when a Rive file is rendered, you can specify the artboard to use. If no artboard is given, the [default artboard](/editor/fundamentals/artboards#default-state-machine), as set in the Rive editor, is used. If no default artboard is set, the first artboard is used.

Only one artboard can be rendered at a time.

<Tabs>
  <Tab title="Compose">
    By default, the `Rive` composable will select and create the default artboard specified in the Rive editor. To specify a different artboard, you must first create an `Artboard` object from a loaded `RiveFile`.

    ### Compose

    Artboard objects can be created in Compose using the `rememberArtboard` function, which takes a Rive file and name of the artboard.

    ```kotlin theme={null}
    val artboard = rememberArtboard(myRiveFile, "My Artboard")
    ```

    ### Outside of Compose

    Alternatively, you can create an artboard outside of Compose contexts. Note that with this approach you are responsible for managing the artboard's lifecycle and must eventually close it with `Artboard::close()` when no longer needed, or leveraging its [`AutoClosable`](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-auto-closeable.html) interface with a `use` block.

    ```kotlin theme={null}
    val artboard = Artboard.fromFile(myRiveFile, "My Artboard")
    ...
    artboard.close()
    ```

    ### Using the Artboard

    Once you have an artboard, you can pass it to the `Rive` composable via the `artboard` parameter.

    ```kotlin theme={null}
    setContent {
        Rive(
            myRiveFile,
            artboard = artboard
        )
    }
    ```
  </Tab>

  <Tab title="Legacy">
    ### Using XML Layouts

    ```xml theme={null}
    <app.rive.runtime.kotlin.RiveAnimationView
        app:riveResource="@raw/my_rive_file"
        app:riveArtboard="My Artboard"
        app:riveAutoPlay="true" />
    ```

    ### Using Kotlin

    ```kotlin theme={null}
    animationView.setRiveResource(
        R.raw.my_rive_file,
        artboardName = "My Artboard",
        autoplay = true
    )
    ```
  </Tab>
</Tabs>