---
title: Blocks
description: Install Initium blocks into a shadcn project through the Initium registry.
slug: blocks
order: 4
---

# Blocks

Initium blocks are shadcn-compatible React sections and page pieces. Install them through the `@initium` registry namespace after your project has shadcn and Initium styles configured.

## Before You Install

Make sure you have:

- Initialized shadcn in your project.
- Added the Initium registry to `components.json`.
- Installed an Initium style preset or the base style pack.
- Set `INITIUM_LICENSE_KEY` if the block is a pro item.

Install the base style pack if you have not installed styles yet:

```bash
npx shadcn@latest add @initium/initium-styles
```

## Install A Block

Use the Blocks browser to choose the exact block name, then install it with shadcn:

```bash
npx shadcn@latest add @initium/hero-section-1
```

The CLI adds the block source code and any required dependencies to your project.

Blocks are built on Base UI and delivered for your project's `style` automatically. Projects on a `base-*` style receive the current Base UI build; projects on a `radix-*` or legacy style receive the frozen Radix build, which stays available for existing customers but no longer receives new blocks.

## Free And Pro Blocks

Some registry items are free. Pro blocks require a valid license key:

```bash
INITIUM_LICENSE_KEY=your_polar_license_key
```

If you can install `@initium/initium-styles` but a pro block fails with an authorization error, your registry setup works and the license key needs attention.

## Install Examples

```bash
npx shadcn@latest add @initium/hero-section-1
npx shadcn@latest add @initium/button-default
npx shadcn@latest add @initium/form-elements-default
```

Use the Blocks browser as the source of truth for available block names. The docs show representative commands instead of duplicating the full block catalog.

## After Installing

Import the installed block into your route or component and pass your real content through the supported props.

Keep the installed style preset intact. If a block looks unstyled, install Initium styles first and confirm the target project is using the global CSS file configured by shadcn.