> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# Lockup

`LockupView` shows the Clearpay logo. Use it where you list Clearpay as a payment method or mention Clearpay without a price.

## Add the lockup

```swift
let lockupView = LockupView(colorScheme: .static(.default))
view.addSubview(lockupView)
```

The lockup keeps its aspect ratio, so set its width and let the height follow. Brand guidelines require a width of at least 64 points. The SDK doesn't enforce this, so set the width yourself. The lockup's background is always transparent.

## Color schemes

The lockup is the Clearpay wordmark in a single color. Choose a palette that contrasts with the background behind the lockup:

| Palette      | Lockup | Use it on         |
| ------------ | ------ | ----------------- |
| `.default`   |        | Dark backgrounds  |
| `.darkMono`  |        | Dark backgrounds  |
| `.alt`       |        | Light backgrounds |
| `.lightMono` |        | Light backgrounds |

`.alt` and `.lightMono` look the same.

If your app supports dark mode, use a dynamic scheme so that the lockup stays visible in both appearances:

```swift
lockupView.colorScheme = .dynamic(
  lightPalette: .alt,
  darkPalette: .default
)
```

## Badges

You can show the Clearpay badge instead of the lockup. `BadgeView` shows the badge, and `CompactBadgeView` shows a slimmer badge with less padding around the wordmark. Both take the same `colorScheme` as the lockup. For the badge colors, see [Color schemes](/guides/sdk/ios-sdk/ui-components#color-schemes).

```swift
let badgeView = BadgeView(colorScheme: .static(.default))
view.addSubview(badgeView)
```