Skip to main content

Documentation Index

Fetch the complete documentation index at: https://app.docs.circuly.io/llms.txt

Use this file to discover all available pages before exploring further.

​
v0.44.0 — May 18, 2026

Added

  • Subscription plan creation is no longer gated by billing tier — every merchant can create plans regardless of their plan.
  • Rental admin surfaces landed (developer preview): inventory, pricing templates, bookings (index, detail, create), rental contracts (index, detail), blackouts (calendar view, holidays, range add), and booking & rentals settings. Hidden behind a developer-merchant gate until GA.
  • Rental storefront integration (developer preview): Liquid date picker block on product pages, live availability paint, and a public Add-to-cart flow that creates a pre-pay Booking tied to the cart.
  • Rentals Phase 3 — the post-payment lifecycle. When a paid order matches a Booking, the app creates a Rental Contract, hooks into orders/create/paid/cancelled/edited webhooks, and refunds the customer end-to-end when an upstream cart conflict cancels the booking.
  • Pricing-template assignment from the rentals admin: mark a product as rental and pick which pricing template applies. Storefront and admin always stay in sync.
  • Rentals demo mode: storefront block and admin pages can render mocked data for sandbox stores and merchant demos.
  • Theme-extension diagnostics banner surfaces extension health on the storefront so merchants can spot widget issues without inspecting the page.
  • Rentals are gated to developer merchants while in preview. Non-developer merchants see no rentals UI yet.

Changed

  • Rental admin pages now use the full admin width so tables with many columns no longer scroll horizontally at default width.

Fixed

  • Theme widgets now render only Circuly’s selling plan groups — native Shopify subscription groups no longer leak into the Circuly widget on storefront product pages.
  • When a rental booking is auto-cancelled because the dates were lost to a faster checkout (layer-3 conflict), the refund now covers the shipping charge as well as the rental — the buyer never received the rental, so the shipping is refunded in full.
  • Storefront app-proxy routes are now aligned with how Shopify strips the proxy path before forwarding to the app — rentals storefront requests reach the right handler.

​
v0.43.0 — May 11, 2026

Added

  • Foundation for short-term rentals — booking lifecycle, availability calendar engine, and a public availability API. No admin UI surface in this release; merchant-facing screens follow in v0.43.1.
  • Phase 1 shared rental inventory layer (foundation that Phase 2 builds on).
  • Suspended merchants are now blocked from authenticated traffic so they cannot keep using the app while their account is on hold.

Changed

  • Internal type cleanups across subscription settings and refund enums to reduce future regressions.

Fixed

  • Billing cron no longer silently skips merchants or misclassifies cycle-mismatched contracts.
  • Selling plan edit page no longer adds phantom variants when the catalog spans multiple pages.
  • Analytics now captures page-leave events for more accurate engagement measurement.
  • Klaviyo integration: the in-app “Klaviyo reference guide” link is restored and now opens the hosted docs (event properties, advanced flow patterns, segment prompts).

​
v0.42.0 — April 30, 2026

Added

  • Brand-new Analytics page with key metrics and per-page metric strips on related screens
  • Shopify Flow integration with 14 subscription lifecycle triggers — automate workflows when subscriptions are created, paused, cancelled, billed, and more
  • Redesigned subscription plan Review step with at-a-glance stat tiles for cleaner pre-save validation
  • Slimmer, modern cross-sell widget that mirrors the parent plan’s billing exactly
  • Cross-sell rules now support a per-row Purchase mode override (one-time vs subscription)

Changed

  • Tabbed widget variant polished further on the storefront
  • Internal type and diagnostics improvements from review follow-ups

Fixed

  • Custom date range in analytics is now re-pickable, and future-date selections no longer cause crashes
  • Plan-edit tables now show the pagination range label
  • Top Products list now tiebreaks by MRR when active subscriber counts match, surfacing the most valuable products first

​
v0.41.0 — April 24, 2026

Added

  • Choose your widget layout during onboarding in the new Appearance step
  • Onboarding now advises previewing your theme before going live
  • New tabbed widget variant and a dedicated Theme settings page in the admin

Changed

  • Onboarding is shorter — the “Your Features at a Glance” step has been removed
  • Shopify extensions upgraded to the latest UI platform versions
  • Shopify dependencies updated to the latest 2025-07 patches

Fixed

  • Pricing adjustments no longer revert to the Variant price unexpectedly
  • Smoother first render and more reliable local setup scripts
  • Invoice template previews show your uploaded logo; WebP is no longer accepted
  • Product prices use Shopify’s current API for better accuracy
  • Customer account layout renders correctly again
  • More reliable navigation inside the customer account extension
  • Fewer background processing hiccups on order and payment events
  • Recent Activity list rows line up consistently across entries
  • Pro plans can now downgrade to Free with a clear confirmation step

​
v0.40.0 — April 17, 2026

Added

  • Subscription limit indicator showing how many subscriptions you’ve used vs your plan cap
  • Free plan no longer charges commission fees
  • Customers can retry failed payments directly from the customer portal
  • Contextual help links added throughout the app for quick access to documentation
  • Selling plan form simplified with a new tabbed layout
  • Create assets directly from the asset page without leaving the screen
  • Onboarding now detects your theme extension and guides setup per template
  • New “About You” step during onboarding to personalize your experience

Changed

  • Subscription type “Normal” renamed to “Rental” — existing data migrates automatically
  • Replaced hardcoded values with proper enums across the codebase
  • Unified brand color consistency throughout the app
  • Development and production app configurations aligned

Fixed

  • Contact Sales link now opens correctly outside the app
  • Billing date editing now uses Shopify’s authoritative cycle range
  • Metafield values are properly validated for uniqueness
  • Billing date restrictions on the client side removed for flexibility
  • Skip and unskip operations now use accurate locally computed dates
  • Subscription eligibility diagnostics improved in the troubleshoot page
  • Store subscription eligibility now correctly reflects merchant status
  • FAQ section repositioned below the support form for better flow
  • Fixed a rendering loop in the admin query hook

​
v0.39.0 — April 13, 2026

Added

  • Cancel subscriptions directly from the admin panel as a merchant
  • Explore the app in demo mode and access developer settings for testing
  • Onboarding setup guide is now clearer with improved steps
  • Open a support ticket directly from the troubleshoot page
  • Your current Shopify plan is now tracked for better support
  • Polished onboarding completion screen with clearer next steps

Changed

  • Updated to the latest Shopify platform version for improved compatibility

Fixed

  • “Deliver every” label no longer shows for non-consumable subscription products
  • Subscription cycle information text is now accurate
  • Selling plan pricing options and number inputs are cleaner and more intuitive
  • Auto-assign rules can no longer be accidentally submitted twice
  • Improved data privacy compliance when stores are removed
  • Improved webhook security and removed unused event handlers
  • Subscription interval validation now prevents invalid values during setup
  • Error messages are now clearer and more helpful

​
v0.38.0 — March 24, 2026

Added

  • Migrate existing subscriptions from other apps into circuly
  • New merchants can explore the app in demo mode before setting up
  • Cleaner frequency dropdown and commitment details in the customer portal
  • Migration tool is now available exclusively on the Custom plan
  • Commission charges now only apply to subscriptions created through circuly
  • Faster subscription plan lookups with local data storage
  • Better visibility into automatic billing with attempt tracking

Changed

  • Updated and corrected merchant-facing documentation
  • Expanded help documentation with 5 new pages

Fixed

  • Payment options display now works reliably across all Shopify themes
  • Improved app loading performance by removing redundant operations
  • Corrected App Store listing links and logos
  • Changelog sections now display expanded by default for easier reading

​
v0.37.1 — March 19, 2026

Added

  • Commission charges now only apply to subscriptions created through circuly — orders from other subscription apps are automatically excluded

​
v0.37.0 — March 12, 2026

Added

  • Scan barcodes or look up serial numbers directly from the app
  • Troubleshoot wizard to diagnose why a product isn’t eligible for subscriptions
  • Automatically assign products to subscription plans by tag
  • Clickable attention cards for faster navigation to issues
  • Your contact email now syncs automatically from Shopify

Changed

  • Redesigned selling plan form for a cleaner, more intuitive setup experience
  • Subscription status badges now use consistent, easier-to-read colors

Fixed

  • Subscription discounts now apply correctly when swapping products or variants
  • Skip and unskip cycle tracking now works reliably
  • Navigation menu correctly hidden for users without an active plan
  • Overdue contracts are now included in automatic billing
  • Clickable rows work consistently across all list pages
  • GDPR compliance webhooks now handled correctly
  • Creating subscription plans now respects your current plan tier
  • Reactivate banner no longer shows for cancelled subscriptions

​
v0.36.0 — March 4, 2026

Added

  • Step-by-step onboarding flow to help you get started faster
  • Refresh button on all list pages for quick data updates
  • See what’s new with the built-in changelog page
  • Simplified setup banner in the extension
  • Filter assets by status and copy serial numbers with one click
  • Subscriptions list page now has a cleaner, more polished layout
  • Error pages now include a direct link to open a support ticket

Changed

  • Internal code improvements for settings pages
  • Dashboard cards have a fresh, polished look
  • List pages now have better sorting and selection features
  • Internal code quality improvements

Fixed

  • Downgrade button now clearly warns before changing plans
  • Clicking a row in list pages now navigates correctly
  • Description field help text is now accurate
  • Selling plan form labels and help texts are clearer
  • Fixed a rare crash when dismissing the What’s New card

​
v0.35.0 — March 2, 2026

Added

  • View billing history directly in the customer portal
  • Search and filter contracts in the customer portal
  • Upgrade prompts now show which features require a higher plan

Changed

  • Billing cycle actions are now more compact and easier to use
  • Variant picker only shows products assigned to the selling plan
  • Internal code improvements for consistency

Fixed

  • Invoice logos now fit properly with a preview before saving

​
v0.34.0 — February 26, 2026

Changed

  • Internal database cleanup for better performance
  • Pricing page descriptions are clearer and easier to understand

Fixed

  • Improved app startup reliability
  • Improved app stability during high traffic
  • Better error display when something goes wrong

​
v0.33.1 — February 26, 2026

Fixed

  • New users are now properly guided to choose a plan on first install

​
v0.33.0 — February 25, 2026

Added

  • New pricing page with side-by-side plan comparison
  • Upgrade prompts appear when accessing features not included in your plan

​
v0.32.0 — February 25, 2026

Added

  • New tiered plan system with different feature levels for each plan

Fixed

  • Invoice template correctly resets to defaults when requested

​
v0.31.2 — February 24, 2026

Changed

  • Faster loading of the subscription widget on your storefront
  • Product rows are now fully clickable for easier navigation

Fixed

  • Improved app stability and error handling
  • Improved app reliability on startup
  • Cross-sell product rows are now fully clickable
  • Cross-sell layout works better on mobile and syncs with cart
  • Improved app reliability during initial setup

​
v0.31.1 — February 23, 2026

Fixed

  • App loads faster with reduced memory usage
  • One-time purchase price updates correctly when switching variants
  • Subscription dropdown highlights the correct option when switching variants
  • Cancellation notice only shows for active subscriptions

​
v0.31.0 — February 20, 2026

Changed

  • Invoice template editor now has tabs for preview, editing, and settings
  • All settings are now on a single page with side navigation

Fixed

  • Dashboard cards and invoice filters are better aligned
  • Reactivation no longer applies to terminated subscriptions
  • Resolved billing and swap timing issues
  • Performance improvements