Gutenberg blocks

TIP Countdown Generator Pro adds two dynamic Gutenberg blocks for displaying countdowns inside the WordPress block editor.

  • TIP Countdown Generator Pro
  • TIP Countdown Generator Pro Builder

Both blocks are rendered dynamically by the plugin. Their output and remaining time are calculated when the page is loaded.

TIP Countdown Generator Pro block

What it does

Displays one countdown previously created and saved in the plugin panel.

When to use it

Use this block when the same countdown configuration must be reused on one or more pages. Changes made to the saved countdown in the plugin panel are reflected everywhere that countdown is used.

How to use it

  1. Open the WordPress block editor.
  2. Click the add block button.
  3. Search for TIP Countdown Generator Pro.
  4. Insert the block.
  5. Open the Saved countdown section in the block sidebar.
  6. Select the countdown to display.
  7. Update or publish the page.

Countdown

Selects one of the countdowns created in the plugin panel. If no valid countdown is selected, the block displays a notice in place of the timer.

TIP Countdown Generator Pro Builder block

What it does

Creates a custom evergreen, specific-date, or recurring countdown directly inside the block editor.

When to use it

Use this block when the countdown configuration is needed only in the current content and does not need to be managed from the plugin panel.

Important notes

The builder settings are stored in the page content. To reuse and centrally manage the same configuration on multiple pages, create a saved countdown and use the standard block instead.

The builder automatically creates a unique countdown ID. The ID remains editable and distinguishes tracking data belonging to different evergreen countdowns.

Builder block sections

  • General
  • Appearance
  • Timer

General

  • ID countdown
    Identifies the countdown in the page markup and separates its evergreen tracking data from other countdowns. A unique value is generated automatically when the block is added, but it can be edited.

Appearance

  • Countdown template
    Selects the frontend countdown layout.
    Available options
    Standard
    Animated Flip
    Flip Clock
    Typewriter
    Paper
  • Alignment
    Aligns the countdown to the left, center, or right.
  • Separators
    Shows or hides the colon separators between time units.
  • Include appearance options
    Enables the custom appearance values listed below. Disable it to use the template defaults.
  • Number font size
    Sets the number size in pixels.
  • Label font size
    Sets the time-unit label size in pixels.
  • Cell background color
    Sets the background color of the countdown cells.
  • Number text color
    Sets the text color of the countdown numbers.
  • Label text color
    Sets the text color of the time-unit labels.
  • Separator text color
    Sets the color of the separators displayed outside the cells.
  • Border radius
    Sets the cell corner radius in pixels.
  • Margin top
    Adds space above the countdown in pixels.
  • Margin bottom
    Adds space below the countdown in pixels.

The custom appearance controls are visible only when Include appearance options is enabled.

Timer

Countdown type

  • Evergreen
    Starts a personal countdown from the visitor’s first tracked visit.
  • Specific date
    Counts down to one absolute date and time using the site timezone.
  • Recurring
    Runs repeated countdown windows according to a schedule.

Evergreen settings

  • Evergreen days
    Sets the day portion of the personal duration.
  • Evergreen hours
    Sets the hour portion of the personal duration.
  • Evergreen minutes
    Sets the minute portion of the personal duration.
  • Evergreen seconds
    Sets the second portion of the personal duration.
  • Tracking method
    Determines how the first visit is recognized and how the countdown start time is shared.

Tracking methods

  • Cookie
    Associates the countdown start time with a browser cookie. A different browser or private session receives a separate countdown.
  • IP
    Associates the start time with the visitor’s anonymized IP address. Visitors sharing the same IP also share the countdown start time.
  • Cookie or IP
    Uses both identifiers and keeps the earliest available start time. A known IP can initialize a new cookie, while an existing cookie can preserve the start time after a network change.
  • Logged-in user
    Associates the start time with the WordPress account, so it follows the user across browsers and devices. Visitors who are not logged in fall back to cookie tracking.

Tracking applies only to evergreen countdowns. The countdown ID is part of every tracking key, so different IDs maintain independent start times.

Specific date settings

  • End date/time
    Sets the absolute date and time when the countdown reaches zero. The site timezone is used.

Recurring settings

  • Repeat every
    Sets the recurrence interval.
  • Recurrence unit
    Repeats the schedule in days or weeks.
  • Duration days, hours, minutes, and seconds
    Define how long each active countdown window lasts.
  • Restart delay days, hours, minutes, and seconds
    Define the pause between the end of one active window and the next restart.
  • Run on days
    Selects the weekdays on which the countdown is allowed to run.
  • On the unselected day(s)
    Countdown to the next selected day displays the time remaining before the next allowed day.
    Hide the countdown timer removes the timer on unselected days.
  • Before start
    Hide timer completely hides all output before the scheduled start.
    Show message only displays only the waiting message.
    Show message and countdown to start displays the waiting message and the time remaining before the active countdown starts.
  • Waiting message
    Sets the message displayed before the scheduled start when the selected behavior includes a message.
  • Start date/time
    Sets the initial date and time used to build the recurring schedule.
  • Timezone
    Uses either the site timezone or a selected custom timezone.
  • Custom timezone
    Selects the timezone used by the schedule when custom timezone mode is enabled.
  • Ends
    Never keeps the recurring series active.
    After recurrences stops it after the selected number of occurrences.
    On date stops it at the selected date and time.
  • End after
    Sets the maximum number of recurrences when After recurrences is selected.
  • End on date/time
    Sets the final date and time when On date is selected.

Action on expiry

Controls what happens when an evergreen or specific-date countdown expires, or when a recurring series reaches its final end condition.

  • Do nothing
    Keeps the expired countdown visible at zero.
  • Hide the timer
    Removes the countdown from the page.
  • Redirect to a URL
    Redirects the visitor to the URL entered in Redirect URL.
  • Display a message
    Replaces the timer with the content entered in Expiry message.

Alignment

Both Gutenberg blocks support wide and full alignment. Availability and final width depend on the active WordPress theme.

License notice

An active TIP Countdown Generator Pro license is required to insert or edit these blocks. Existing blocks continue rendering on the frontend when the license is inactive, but their settings remain locked in the editor.