---
title: "Countdown Progress Bar"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.giveawaygator.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Countdown Progress Bar

The countdown progress bar is a visual component that transforms countdown timers into animated progress bars.

## Key Features
- **Minimum 50% fill** — never looks empty
- **Smart progress**: 50% baseline at 4+ days, linear to 100% in final 4 days
- **5 animation types**: None, Pulse, Gradient Flow, Left to Right Pulse, Glow Pulse
- **Slanted bars overlay** with customizable width and speed
- **Shadow & glow effects** with color and intensity control

## Implementation Methods

**Method 1: Theme Editor Block**
Add the "GG Progress Bar" block in the Shopify theme editor. No code required.

**Method 2: Custom Liquid (Class-Based)**
```html
<div class="gg-countdown-progress"></div>
```

**Method 3: Page Builder (Attribute-Based)**
```html
<div gg-countdown-progress></div>
```

You can also use `data-gg-countdown-progress`. See [End time](#end-time).

## End time

By default, the bar moves toward the end of the active bonus period when one is running. If no bonus period is active, it moves toward the giveaway end.

Add `data-gg-end="promo"` to skip the bonus period and always use the giveaway end.

```html
<div data-gg-countdown-progress data-gg-end="promo"></div>
```

Turn on the Giveaway Gator app embed. The bar starts when the page loads, and it updates in the theme editor when you add or remove sections.

If the giveaway has no end date, or that date has already passed, the bar stays hidden.

## CSS Variables

```css
/* Core */
--gg-progress-height: 20px;
--gg-progress-border-radius: 10px;
--gg-progress-start-color: #ef4444;
--gg-progress-end-color: #dc2626;
--gg-progress-bg: #e5e7eb;

/* Animation */
--gg-animation-speed: 2s;
--gg-slanted-speed: 1.5s;
--gg-slanted-width: 8px;

/* Shadow & Glow */
--gg-progress-shadow: 0 0 20px #ff0000;
--gg-glow-color: #ff0000;
```

## Page Builder Integration
Works with PageFly, GemPages, Shogun, and LayoutHub — use their HTML/Custom Code blocks.

Source: https://docs.giveawaygator.app/countdown-progress-bar/index.mdx
