The contest form block lets you embed a contest entry form directly into any page of your Shopify theme as an inline section. Unlike the popup, the form sits within the page content — no modal overlay.

## Adding the Form Block

1. In your Shopify admin, go to **Online Store > Themes**.
2. Click **Customize** on your active theme.
3. Navigate to the page where you want the form (e.g., homepage, a custom page).
4. Click **Add section** or **Add block** and look for **Contest Form**.
5. Select which contest to display using the contest picker.
6. Configure the settings (see below).
7. Click **Save**.

## Contest Selection

Use the **Contest** metaobject picker (app-owned) to choose which active contest the form should display. Only active contests appear in the picker. If no contest is selected, an empty placeholder state is shown in the theme editor.

If this block was configured before app-owned metaobject migration, the **Contest (Legacy)** picker remains available and will continue to work.

## Layout Options

Choose how the form is arranged:

- **Vertical** (default) — Title, description, prizes, and form fields stack top-to-bottom. Best for narrow columns or sidebars.
- **Horizontal** — Content and form fields sit side by side. Best for wider sections.
- **Compact** — A minimal layout with just the essential form fields. Best when space is limited.

## Max Width

Control the maximum width of the form block: 300px to 800px (default: 500px). The form is centered within its container.

## Display Options

Toggle what content appears in the form:

- **Show contest title** (default: on)
- **Show description** (default: on)
- **Show prizes** (default: on)
- **Show contest dates** (default: off)
- **Show terms link** (default: on)

## Style Settings

**Use contest colors** (default: on)
When enabled, the form uses the colors you configured on the contest's Design tab. When disabled, you can set custom colors per-block:

- **Button color** — The submit button color
- **Background color** — The form background
- **Text color** — All text in the form

**Additional text options:**
- **Button text** — Custom CTA text (default: "Enter to Win")
- **Success message** — Custom text shown after entry (default: "You're entered! Good luck!")

## Where to Use It

The form block works well on:

- **Homepage** — As a section to highlight your current giveaway
- **Product pages** — Alongside products related to the prize
- **Landing pages** — Custom pages dedicated to your contest
- **Blog posts** — Within content announcing the giveaway

## Form Block vs. Popup

| Feature | Form Block | Popup |
|---|---|---|
| Display type | Inline, part of page content | Modal overlay |
| Trigger | Always visible | Time delay, scroll, or exit intent |
| Best for | Dedicated sections, landing pages | Passive capture across the site |
| Layout options | Vertical, horizontal, compact | Fixed popup layout |
| Width control | 300–800px | 300–600px |
| Frequency control | N/A (always visible) | Per session/day/visitor |

You can use both the form block and popup on the same store — they work independently.