Copyright & Attribution

Views that handle attribution for you

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

• BibleCardView
• BibleReaderView

Both views 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 views.

Displaying attribution yourself

BibleTextView 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(withId:) 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.

AttributedPassageView.swift
import SwiftUI
import YouVersionPlatform

struct AttributedPassageView: View {
    let reference: BibleReference

    @State private var version: BibleVersion?
    @State private var failed = false

    var body: some View {
        Group {
            if failed {
                Text("Unable to load copyright attribution for this passage.")
            } else if let version {
                VStack(alignment: .leading, spacing: 12) {
                    BibleTextView(reference)

                    if let attribution = version.copyright ?? version.promotionalContent {
                        Text(attribution)
                            .font(.footnote)
                            .foregroundStyle(.secondary)
                    }
                }
            } else {
                ProgressView()
            }
        }
        .task(id: reference.versionId) {
            version = nil
            failed = false

            do {
                version = try await YouVersionAPI.Bible.version(
                    withId: reference.versionId
                )
            } catch is CancellationError {
                // A new version ID starts a replacement task.
            } catch {
                failed = true
            }
        }
    }
}

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.