Copyright & Attribution

Components that handle attribution for you

The following components fetch and display attribution with the passage — no extra work is required:

• BibleCard
• BibleReader

Both components prefer the version's brief copyright value and fall back to promotionalContent when the brief value is unavailable.

If attribution matters for your screen and you do not need a custom layout, prefer one of these components.

Displaying attribution yourself

BibleText gives you full control over layout and does not display the passage reference, Bible version, or copyright. When you use it, you are responsible for displaying appropriate attribution.

Fetch the BibleVersion with YouVersionApi.bible.version(...) and render its copyright near the passage, falling back to promotionalContent when needed. The example waits for the metadata request before showing the passage so the text is never displayed without its attribution lookup having completed.

AttributedPassage.kt
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.height
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import com.youversion.platform.core.api.YouVersionApi
import com.youversion.platform.core.bibles.domain.BibleReference
import com.youversion.platform.core.bibles.models.BibleVersion
import com.youversion.platform.ui.views.BibleText
import kotlinx.coroutines.CancellationException

@Composable
fun AttributedPassage(reference: BibleReference) {
    var version by remember(reference.versionId) {
        mutableStateOf<BibleVersion?>(null)
    }
    var failed by remember(reference.versionId) { mutableStateOf(false) }

    LaunchedEffect(reference.versionId) {
        try {
            version = YouVersionApi.bible.version(reference.versionId)
        } catch (error: CancellationException) {
            throw error
        } catch (error: Exception) {
            failed = true
        }
    }

    when {
        failed -> Text("Unable to load copyright attribution for this passage.")
        version == null -> Text("Loading…")
        else -> Column {
            BibleText(reference = reference)
            Spacer(modifier = Modifier.height(12.dp))
            version?.let { it.copyright ?: it.promotionalContent }?.let { attribution ->
                Text(
                    text = attribution,
                    color = Color.Gray,
                    fontSize = 12.sp,
                )
            }
        }
    }
}

The BibleVersion metadata provides two related fields:

• copyright — brief attribution to display near the verses.
• promotionalContent — a fuller copyright or publisher notice, suitable for a version-details, settings, or about screen and used as the nearby attribution fallback when copyright is unavailable.

Some public-domain versions may not provide copyright text. Treat a successful response with a missing field differently from a failed metadata request.