Form Block

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

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