SeasonFlow
Privacy Policy Contact Support
SeasonFlow Documentation

Create, place and schedule seasonal sale widgets.

SeasonFlow is a Shopify app for building customizable promotional widgets for seasonal sales, holidays, announcements and special offers. Use templates or start from a blank design, customize desktop and mobile layouts, choose storefront placement, schedule campaigns and track engagement.

Documentation updated: October 16, 2026

1. SeasonFlow Overview

SeasonFlow helps Shopify merchants build eye-catching sale widgets without editing theme code for every promotion.

Seasonal templatesStart quickly with designs for Black Friday, Cyber Monday, Christmas, Winter Sale, New Year's, Valentine's Day, Mother's Day, Father's Day, Back to School, Halloween, Thanksgiving and more.
Flexible placementUse Top of Page, Sticky Footer, Inline and Corner Slide placements depending on the promotion and page layout.
Responsive designCustomize desktop and mobile presentation separately while keeping the core widget content consistent.
Animated SVG backgroundsChoose animated patterns, recolor them to match a campaign, and combine motion with gradients, media, badges and other styling controls.
SchedulingStart widgets immediately or schedule start and end times using the Shopify store timezone.
StatisticsTrack views, clicks, CTR and device mix. Pro adds conversion reporting such as add to cart, orders and revenue.
SeasonFlow is designed as a promotional widget builder, not a replacement for the Shopify theme editor. Your theme still controls the store itself; SeasonFlow adds promotional experiences on top of or inside supported storefront locations.

2. Quick Start

1
Install SeasonFlowOpen SeasonFlow from Shopify Admin and confirm the app loads inside the Shopify admin.
2
Enable the app embedOpen the theme editor, enable the SeasonFlow app embed if it is not already active, and save the theme.
3
Create a widgetSelect + Create Widget, choose a placement and start from a template or blank design.
4
Customize the designEdit content, columns, backgrounds, badges, close button styling, links and responsive settings.
5
Add it to the storefrontEnable the widget. For app-block placements, use Add to theme or paste the copied Widget ID into the SeasonFlow Widget block.
6
Preview and testCheck desktop and mobile views, confirm the link target, verify schedule settings, then save your theme changes.

3. Shopify Theme Setup

SeasonFlow uses Shopify theme app extension functionality. The theme editor can contain a SeasonFlow Widget app block, and the SeasonFlow dashboard shows whether the app embed is active.

Enable the SeasonFlow app embed

  1. Open your Shopify theme editor.
  2. Open App embeds.
  3. Turn on the SeasonFlow app embed.
  4. Click Save.
  5. Return to SeasonFlow and refresh if the dashboard has not updated yet.

Add an inline/app-block widget

  1. In SeasonFlow, locate the widget on the dashboard.
  2. Click Copy ID, or use Add to theme where available.
  3. In the Shopify theme editor, add a SeasonFlow Widget app block to the desired section.
  4. Paste the Widget ID into the block's Widget ID field.
  5. Turn on Show Widget.
  6. Save the theme.
Theme editor example: add the SeasonFlow Widget block, paste the Widget ID, turn on Show Widget, and save the theme.
If the theme editor says “Widget not found”: confirm that the Widget ID matches the widget in SeasonFlow, the widget still exists, and you are editing the intended Shopify theme.

4. Widget Dashboard

The SeasonFlow dashboard is the control center for creating, enabling and placing widgets. It shows app embed status at the top and provides actions for each widget.

ControlPurpose
Create WidgetStarts a new promotional widget.
Copy IDCopies the widget identifier used by the Shopify theme app block.
Add to themeHelps open/add the widget in the theme where supported.
Enabled toggleControls whether the widget is active.
••• menuProvides additional widget actions.
SeasonFlow dashboard showing app embed status, widget types, Copy ID, Add to theme and Enabled controls.

5. Widget Placements

SeasonFlow's launch version supports four core placement styles. Exact controls vary by placement.

Top of PageDisplays a promotional widget at the top of the storefront. Behaviour controls can make it disappear on scroll, remain in position, use a parallax-style scroll effect, or stick to the top.
Sticky FooterDisplays a persistent promotional widget at the bottom of the viewport. It can show immediately and can optionally hide when the shopper reaches the page bottom.
InlinePlaces a widget inside a theme section or page using the SeasonFlow Widget app block and Widget ID.
Corner SlideDisplays a compact slide-style promotion from a side/corner location, ideal for attention-grabbing offers without occupying the full page width.
Choose the placement based on how important the promotion is and how much of the storefront you want it to occupy. Use Top of Page or Sticky Footer for broad campaigns, Inline for page-specific content, and Corner Slide for a more compact promotion.

6. Widget Builder

The builder is organized into tabs. The available controls can vary depending on the selected placement and element.

GeneralChoose templates and manage the widget's content and structure.
DesignAdjust visual styling such as colors, borders, rounded corners, shadows, hover states and spacing.
BackgroundChoose Color, Gradient, Media or Animated background treatments.
BehaviourControl placement-specific display and scroll behaviour.
LinkSet the whole-widget destination URL and whether it opens in a new window.
Close ButtonEnable, style, size and animate the close control.
ScheduleControl when the widget starts and ends.
The General tab provides template starting points and keeps the storefront preview visible while you work.

7. Templates

Templates provide a fast starting point for seasonal promotions. The current library includes blank designs plus seasonal and message-oriented templates.

Black FridayCyber MondayChristmasWinter SaleNew Year'sValentine's DayMarch MadnessSt. Patrick's DayMother's DayFather's DayCanada Day4th of JulySummer SaleBack to SchoolThanksgivingHalloween

Message templates can also be used for general promotions such as gift guides, last-chance messaging, installation sales and blog-related promotions.

A template is a starting design. After selecting a template, continue customizing the widget to match the merchant's brand, campaign and responsive layout requirements.

8. Desktop & Mobile Design

SeasonFlow includes separate desktop and mobile editing modes so a merchant can fine-tune responsive presentation without creating two different widgets.

Shared across desktop and mobile

  • Applied template and core widget content
  • Heading, subheading and CTA text
  • CTA action / destination and whole-widget URL
  • Open-in-new-window choice
  • Schedule and behaviour settings

Can be adjusted separately by device

  • Font size, styling, alignment and spacing
  • CTA sizing and visual treatment
  • Column widths, stacking and positioning
  • Widget dimensions, padding and margins
  • Badge and image size/position
  • Background positioning and sizing
  • Close button size and position

Desktop acts as the main starting design. Mobile can then be adjusted independently so mobile changes do not need to alter the desktop presentation.

Use the desktop/mobile controls to create different responsive layouts. Columns can be reordered, shown/hidden and sized as needed.

9. Backgrounds & Animated SVG Styles

The Background tab gives merchants several ways to build the visual foundation of a SeasonFlow widget. You can keep a promotion simple with a solid color, create a branded gradient, use media, or add an Animated SVG background for movement and extra visual impact.

ColorUse a single solid background color for clean, minimal promotional bars and messages.
GradientBlend two colors with adjustable opacity and direction to create softer transitions or bold branded effects.
MediaUse uploaded imagery as part of the widget background when a campaign needs photography or custom artwork.
Animated SVGChoose from animated vector-style patterns such as stripes, waves, diagonal bands and radial effects to give the widget subtle or high-energy motion.

Animated SVG backgrounds

Animated backgrounds are designed to make a promotion feel more alive without changing the widget's core content. They work behind the headings, buttons, images and badges, so the merchant can keep the same promotion while changing the motion treatment to suit a season or campaign.

SeasonFlow includes a gallery of animated styles that can be selected directly from the Animated tab. Depending on the selected style, merchants can adjust the available colors and opacity values so the animation can be matched to their store branding or seasonal palette.

Start with a styleSelect an animated pattern from the visual style library instead of building motion from scratch.
Recolor the animationUse the built-in color controls and hex values to quickly transform the same animation for Black Friday, Christmas, New Year's, spring sales and other campaigns.
Keep the design responsivePreview the result on both desktop and mobile and fine-tune the widget layout so the animated treatment supports the message instead of competing with it.
Design tip: Animated backgrounds are most effective when the motion supports the promotion. High-contrast moving stripes can work well for urgent sales, while softer waves or subtle patterns can add movement without distracting from the CTA.
Choose an animated SVG style from the visual library. SeasonFlow includes a range of patterns that can give a promotion a different sense of movement and energy.
Many animated styles can be recolored with campaign-specific colors and opacity controls. Here, the background colors are coordinated with the New Year's sale badge and border treatment.

Other background and styling controls

Additional styling can include full-width display, fade-in behaviour, borders, rounded corners, outside box shadow and desktop/mobile spacing. These controls can be combined with animated backgrounds to create anything from a restrained announcement bar to a much more graphic seasonal promotion.

Gradient & design controls

Gradient background example with color, opacity, direction, width, fade, border, corners, shadow and spacing controls.
Design controls can style selected widget elements with borders, rounded corners, shadow, hover states and responsive spacing.

10. Sale Badges & Promotional Graphics

SeasonFlow can add attention-grabbing sale badges such as percentage-off graphics. Merchants can select a badge, customize its colors, upload an image, move its position and change its size.

Badges are intentionally more flexible than a traditional element locked inside a rectangular banner. Depending on the widget design and placement, a badge can extend beyond the widget boundary and overlap nearby storefront content. This layered treatment can make a promotion feel more like a designed graphic and helps important sale messaging stand out.

Badge styling can also include color opacity, blur, spread and positioning controls where available.

Design tip: Use overlap sparingly and preview both desktop and mobile. The goal is to create an eye-catching layered promotion without covering important navigation, product information or purchase controls.
Badge example: change the percentage-off badge color, placement, size and visual effects while previewing the result.
Badges can extend outside the traditional widget rectangle to create a layered, more eye-catching storefront graphic.

11. Behaviour Settings

Behaviour options depend on widget placement.

Sticky Footer example

  • Hide when reaches page bottom — prevents the sticky widget from covering content at the bottom of a page when enabled.
  • Show widget right away — displays the widget without waiting for an additional trigger.
  • Cookie Settings: Show all the time — controls repeat display behaviour for visitors.
Sticky Footer behaviour options shown in the builder.

Top of Page example

  • Use parallax when scrolling away
  • Make widget stay in same position
  • Make widget disappear once scrolled out of view
  • Make widget stick to top on scroll
  • Show widget right away
Top of Page widgets have additional scroll and sticky-position behaviour controls.
Some behaviour options are mutually exclusive in practice. Preview the storefront after changing scroll/sticky settings to confirm the widget behaves the way you expect.

13. Close Button

The Close Button tab lets merchants control whether shoppers can dismiss the widget and how the close control looks.

Like SeasonFlow badges, the close button is not limited to sitting neatly inside the widget rectangle. It can be positioned so it breaks outside the traditional section boundary and overlaps surrounding storefront content. This makes the close control easier to see and can add a polished, layered visual treatment to the promotion.

  • Enable or disable the close button.
  • Select a built-in close button or upload an image.
  • Customize background and stroke colors.
  • Configure hover colors.
  • Use available animation options such as spin or fade-between.
  • Adjust close button size.
Close Button controls allow the dismiss icon to be matched to the campaign design.
The close button can sit partly outside the widget boundary, making it visually distinct while remaining easy for shoppers to find.
Preview close-button placement on desktop and mobile to make sure it does not cover important storefront controls or content.

14. Scheduling & Cookie Settings

SeasonFlow gives you two different levels of control: scheduling determines when a promotion is active, while cookie settings control how often an individual visitor sees that active promotion.

Schedule when a promotion runs

Start immediatelyMake the widget eligible to display as soon as it is enabled.
Schedule startChoose the exact date and time when the promotion should begin.
Schedule endChoose the exact date and time when the promotion should automatically stop displaying.
No end dateKeep the widget eligible to display until you manually disable it or change its settings.

Use scheduled start and end times for campaigns such as Black Friday, Cyber Monday, holiday weekends, flash sales, product launches or any promotion that should turn on and off automatically. Start and end can also be set on the same day for a short promotional window.

Store timezone: SeasonFlow bases scheduled start and end times on the Shopify store timezone shown in the Schedule tab. This helps the promotion begin and end according to the merchant's store settings rather than the device being used to edit the widget.
Choose a scheduled start and/or end date and time, or use Start immediately and No end date for an open-ended promotion.

Control how often visitors see a widget

Cookie Settings help prevent a promotion from becoming repetitive. They are especially useful for Sticky Footer and Corner Slide widgets that remain highly visible while a shopper browses the store.

Show all the timeUse this when you want the widget to remain available every time the shopper reaches an eligible page while the promotion is active.
Show once every X hoursLimit repeat exposure. For example, entering 24 lets you show the widget again after the selected 24-hour interval instead of repeatedly showing it during every visit.
After clicked, don't show for X hoursGive shoppers a break after they engage with the promotion. For example, setting this to 24 can keep the widget hidden for the next 24 hours after that visitor clicks it.
Scheduling and cookie settings work together. The schedule decides whether the campaign is currently eligible to run. The cookie settings then decide how frequently that eligible widget should be shown to the same visitor.
Frequency controls can reduce repeat exposure by limiting how often the widget appears or by temporarily hiding it after a shopper clicks it.

Example setups

  • Weekend Black Friday sale: Schedule the widget from Friday at 12:00 AM until Sunday at 11:59 PM and use Show all the time for maximum visibility.
  • Corner Slide promotion: Schedule the campaign normally, then use Show once every 24 hours so the slide-in does not appear repeatedly to the same shopper.
  • Coupon or offer after engagement: Enable After clicked, don't show for and choose an interval so customers who already interacted with the offer are not immediately shown the same promotion again.
When testing visitor-frequency settings, remember that browser-based site data can affect whether the widget is considered previously viewed or clicked. Testing in another browser, a private window, or after clearing relevant site data can behave like a new visitor.

15. Statistics & Reporting

SeasonFlow includes a Statistics panel for each widget so merchants can see how a promotion is performing without leaving the app.

ViewsSee how many times the widget was viewed during the selected reporting period.
Clicks & CTRTrack shopper interactions and the click-through rate for the promotion.
Device breakdownSee the percentage of widget activity coming from desktop and mobile visitors.
Conversion reportingPro can include deeper performance metrics such as Add to Cart, Orders and Revenue.

Use the 7 days, 30 days and 90 days controls to change the reporting window. The chart below the summary helps visualize activity over time.

MetricAvailabilityMeaning
Views / ImpressionsFree & ProHow many times the widget was displayed or viewed.
ClicksFree & ProHow many tracked clicks occurred on the widget.
CTRFree & ProClick-through rate based on widget views and clicks.
Desktop / MobileFree & ProDevice share for tracked widget activity.
Add to CartPro conversion analyticsTracked add-to-cart activity attributed to the promotion where supported.
OrdersPro conversion analyticsTracked orders attributed to the promotion where supported.
RevenuePro conversion analyticsTracked revenue attributed to the promotion where supported.
The Statistics panel summarizes widget performance, device split and reporting trends over selectable date ranges.
On the launch Free plan, engagement reporting includes views/impressions, clicks and CTR. Conversion-level reporting is a Pro feature.

16. Free & Pro Plans

The launch version of SeasonFlow intentionally offers a generous Free plan so merchants can fully experience the widget builder before upgrading.

Free

$0
  • Unlimited promotional widgets
  • Unlimited enabled widgets
  • Access to all templates
  • Schedule promotional campaigns
  • Track impressions, clicks and CTR
  • SeasonFlow branding on widgets
  • No conversion analytics

Pro

$9.99 / month
  • Everything in Free
  • Conversion analytics
  • SeasonFlow branding removed

Current plan details are shown for the launch version and may be updated as SeasonFlow evolves.

17. Troubleshooting

Widget does not appear on the storefront

  1. Confirm the widget is Enabled in SeasonFlow.
  2. Confirm the SeasonFlow app embed is active in the theme.
  3. If using an app block, confirm the correct Widget ID is pasted into the SeasonFlow Widget block.
  4. Confirm Show Widget is turned on in the app block.
  5. Click Save in the Shopify theme editor.
  6. Check the Schedule tab to make sure the current date/time is inside the active window.
  7. Check Behaviour settings, including whether the widget was previously dismissed.
  8. Make sure you are previewing the same theme where the SeasonFlow block/embed was configured.

Theme editor says “Widget not found”

Copy the Widget ID again from the SeasonFlow dashboard and paste it into the app block. Also confirm the widget has not been deleted.

Schedule appears to start at the wrong time

Check the timezone shown in the Schedule tab and compare it with the Shopify store's configured timezone.

Desktop looks correct but mobile does not

Switch to the mobile editing mode and adjust the mobile-specific layout, typography, spacing, badge position and close button settings.

18. Frequently Asked Questions

Do I need to edit theme code?

No for normal use. SeasonFlow uses Shopify theme app extension features, app embeds and app blocks. Inline placements may require adding a SeasonFlow Widget block in the theme editor, but this does not require manually editing theme source code.

Can I create more than one widget?

Yes. The launch Free plan supports unlimited promotional widgets and unlimited enabled widgets.

Can I schedule a widget?

Yes. Use the Schedule tab to start immediately, schedule a start, schedule an end, or leave the widget without an end date.

Can desktop and mobile look different?

Yes. SeasonFlow supports responsive desktop and mobile design controls so layout and styling can be adjusted separately while the core content remains shared.

Can I use my own link?

Yes. Use the Link tab to set a destination for the whole widget. CTA elements can also have their configured actions.

What statistics are included?

Free includes views/impressions, clicks and CTR. The Statistics panel also shows device breakdown. Pro adds conversion-level reporting such as Add to Cart, Orders and Revenue where supported.

How can I contact SeasonFlow support?

Use the green Chat widget at the bottom of the page to message us directly, or email shawn@melodicmedia.com.

Why is there a SeasonFlow logo on my widget?

SeasonFlow branding is part of the Free plan. Upgrade to Pro to remove the branding.

19. Support

If you need help installing SeasonFlow, adding a widget to your theme, troubleshooting a placement or configuring a campaign, you can chat with us directly using the green Chat widget at the bottom of the page. This is the quickest way to ask a question while you are working in SeasonFlow.

Use the Chat widget at the bottom of the page to contact us directly.

You can also contact:

MelodicMedia
55 Severn Drive
Guelph, Ontario
Canada N1E 0M9

Email: shawn@melodicmedia.com

Privacy: SeasonFlow Privacy Policy