Limio Release Notes - Release 88
Summary
- New features: Page Builder v2 and modular checkout enhancements, set cookie by domain, variable billing frequency at offer level, improvements to our SDK to better support Apple Pay - Bug fixes: Promo codes quantity, Zuora double refunds
Please remember to perform a hard refresh in your browser after upgrading your environment.
New Features and Improvements
Improvements to the SDK to better support Apple Pay
We've added functionality to our SDK so that users can implement the Apple Pay button on a variety of Limio pages.
Read our guide for this new functionality here:
Variable billing frequency at offer level
Limio's Initial Pricing functionality allows for greater flexibility and control when defining promotional pricing. This feature is being extended to support cases where you may want your initial billing frequency to be different than your renewal billing frequency. For example:
A free, 1-week trial that renews into a paid monthly subscription
Special promotional pricing paid once for 1 year that renews into a monthly paid subscription
This feature can be configured at the offer level, instead of the domain level. Please see this guide for more information on how to configure this new functionality:
Screenshot: The new toggle is available on the offer level.
Set cookie by domain
Limio Commerce users can now define in which domain Limio cookies will be set. They can be set as follows:
If toggle is true, then the Limio cookies are set on the main domain.
If toggle is false, then the Limio cookies is set using current behaviour (not specified).
Screenshot: Find this new setting in General Settings > Site Security.
Self service components no longer show "initial" status subscriptions
When a subscription is processing or has failed, it has the status "initial". The self service components are now updated to no longer show "initial" status subscriptions for a clearer customer experience. Only Active and Cancelled subscriptions will be shown.
Send reason to Zuora in refund orders
If a refund order includes a reason code, it will now be sent to Zuora on order processing. To maintain backwards compatibility, if no refund code is specified, "Compensation" will be sent instead.
Screenshot: If the reason code is included in a refund order, it will populate in Zuora.
Allow for future or past subscription start dates
In Zuora, the subscription start date can be any day in the future or past. The Limio order processing has been enhanced so that if the "overrideStartDate" attribute is set in the order, then the start date in Zuora will be that date. Otherwise, if it is not set, then the start date will be today.
The "overrideStartDate" can be set through custom order processing, the Limio Date Field, or through Limio for Salesforce.
Read more about the Limio Date Field here:
Read more about setting a new start date through Limio for Salesforce here:
Change renewals behaviour in Block Purchase Dialog component
The new behaviour defined in the Block Purchase Dialog component for renewals is as follows:
Check if a customer has any subscriptions.
If they have 1 subscription (lapsed or active), then we allow the customer to renew.
If they have more active or lapsed subscriptions, then we display a dialog to say that they have more than 1 subscription and they need to change their subscription elsewhere (in self-service or with an agent).
Improved UI for cancelled subscriptions in Orders Table
Subscriptions that are cancelled will now have "N/A" in the auto-renew field of the Orders Table component.
Read more about the Orders Table component here:
Zuora Account and Contact in Entitlements webhook
The Entitlements webhook payload has been updated to include the Zuora account and contact if known. Additionally, the payload has been updated to return "service" and "type" instead of "https://limio.com/service" and "https://limio.com/type".
Read more about entitlements here:
Limio APIs published for external use
Some internal Limio APIs have been published for customer use, specifically the Order API and the Preview API.
Read further information on these APIs here:
External integration framework
Limio has a new integrations router to make Limio integrations with external services easier and quicker to develop and deliver. Using this new integrations router, Datatrans is a new payment method available to Limio customers via the Zuora Universal Payment Connector (UPC).
Please reach out to if you are interested in a Limio integration with an external service, if you are interested in using Datatrans, or if you are interested in a Limio integration with another UPC service.
Use variables in invalid messages on the State and Post Code subcomponents
It is now possible to use Limio variables in the invalid message field on the State and Post Code subcomponents. For example, users may want to display a message on the State field like "Please enter a {{state_name_type}}" to offer customers further guidance in completing a Form.
Screenshot: Users can enter a Limio variable in the "Invalid message" field on subcomponents.
Read more about the Form component, which is made up of subcomponents, here:
Read more about Limio variables here:
See styling in real time with Page Builder v2
The page your customers see in the Shop and the page you edit in the Page Builder v2 will now look the same. Limio Commerce users can update styling via the Style tab, and see the changes in real time in the page builder.
Screenshot: Change the styling and see the updates in real time in the Page Builder v2.
Read more about styling in Page Builder v2:
Country code selector for phone numbers in Page Builder v2
In Page Builder v2, users now have the option to configure a country code dropdown on the Field subcomponent when the type is “phone number”. When this toggle is enabled, customers in the Shop will see a dropdown with country codes so they can enter their phone number more quickly.
Screenshot: In the Limio Field subcomponent, when the type is set to phone number, Limio Commerce users can toggle the Phone Number Picklist prop.
Screenshot: If the Phone Number Picklist prop is toggled on, then customers in the Shop will see the country code dropdown while entering their phone number.
Read more about the Field subcomponent here:
Quickly create checkout with the Form Checkout component
Create a checkout more quickly using the new Form Checkout component. The Form Checkout replicates the Single Page Checkout component but using the Form subcomponents instead. This gives you greater flexibility without increasing the time spent configuring your checkout.
Screenshot: Quickly create a modular checkout form with the new Form Checkout component. Create a blank form from scratch with the Form component.
Read more about the Form Checkout component here:
Improve link display in Page Builder v2
The link display in Page Builder v2 has been improved with the following logic:
If only the Limio shop domain is configured, display the link with Limio domain.
If a single, custom domain is configured, display the link with that custom domain.
If multishop is configured, display the link with the domain configured on the Page Template (Templates > Pages > Domain). If there is no link configured on the Page, display the link with the Limio domain.
Screenshot: In this example, there is no custom domain configured, so the Limio shop domain appears as the displayed URL.
Screenshot: If a custom domain is configured on the pages template, then that domain will be displayed in the Page Builder v2, with the appropriate tag(s).
Read more about multishop here:
Duplicating redirects to new Page v2
When users duplicate a Page in the Page Builder v2, they are now redirected to the new page. Previously, they stayed on the duplicated page.
Screenshot: Duplicate the page by clicking the downward arrow in the top right corner, and selecting "Duplicate current".
Configure max selectable days in Date type Field in Page Builder v2
Users can now configure the Date field subcomponent to have a max selectable day in the future for customers. If the Max days in future prop is left blank, there will be no date range limit. However if it is populated, then the customers can only select a day in the future up to that maximum day.
Screenshot: If the "Max days in future" prop is set to 2, then the customer will only be able to select a date up to 2 days in the future.
Error handling in the Form component
Limio Commerce users can configure failure messages on the Form component, in the event of failed form submission. Its possible to both set a rich text message, and modify the colour scheme of the notification.
Screenshot: Users can set the invalid form message and colour scheme in the Form component.
Read more about the Form component here:
See user data with user tab in Page Builder v2
See what your users see with the new User tab in the Page Builder v2. Enter a valid customer ID to see the subscriptions linked to your customer, along with payment methods, offers, addresses, and schedules. Additionally, this will change the view in the Page Builder v2 so you can see what that specific user would see. This can be especially helpful when working on a self-service page.
Screenshot: Access this new feature by clicking on the User button in the top right corner of Page Builder v2.
Screenshot: See all data linked to the customer ID inputted.
New card label in Modular Checkout
The "Debit or Credit Card" label has been updated to display as "Card" in the Payment Details subcomponent of the Form component in the modular checkout. The Single Page Checkout component will not be affected by this change.
Screenshot: The label has been updated to "Card" in the modular checkout only.
Gift checkout via Modular Checkout
Limio Commerce users can now use the Modular Checkout for gift redemption pages. This allows for greater flexibility in the fields collected during the gift checkout process.
Screenshot: An example of a gift checkout using the Modular Checkout.
Read more about creating gift checkouts here:
Increased accessibility on the orders table component
The aria label of all buttons on the orders table component will now match with the text specified on the button labels.
Improved consistency with Order API
The order API has been improved to allow for changes to address and customer detail to be more precise and consistent.
Component refactoring
Our components have undergone refactoring to increase stability, specifically the order confirmation, order description, payment method confirmation, and cancel save components.
Bug Fixes
Script tags not working in hosted-component
Script tags were not loading as expected which meant that functionality was missing from some hosted-components. This issue has been fixed so that hosted-components work as expected and have full functionality.
'Region' and 'Postal code' labels are undefined for some countries
Region and Postal code labels were undefined for some countries: Greenland, Holy See, Isle of Man. This has been addressed and these labels are defined for all countries.
Dropdown doesn’t show options in the Field Subcomponent
In the Field subcomponent in the Form component, the dropdown was not showing options. This has been fixed so that the dropdown does show options.
Validation isn't working for Limio Field in Page Builder v2
Validation was not working in the Limio Field subcomponent when it was added to the Form component. Customers could proceed to checkout after entering values outside of the minimum and maximum length defined. Validation has been fixed: the field is highlighted in red when the value is invalid and the customer cannot proceed to checkout when entering disallowed values.
Evergreen subscriptions not syncing
When changes were made to an evergreen subscription in Zuora, syncing those changes to Limio caused errors in Limio. This has been fixed so that it is possible to sync changes made to an evergreen subscription in Zuora to Limio.
Tag can be added to multiple pages
A single tag could be added to multiple pages. This has been fixed so that each tag can only be added to a single page.
State field populates state value when changing from CA/US to other country
In modular checkouts that use country, post code, and state inputs, if a customer selected CA or US and a state and then changed the country selected to any country other than CA or US, the state input was populated with the previous state value. This has been fixed so that the state input is empty when a customer selects a country other than CA or US.
Pagination isn't working in Pages v2 view lis
It was not possible to click away from the first page of results in Pages v2 list view. This has been fixed and pagination is working as expected, with all results in the list view accessible.
Empty components not visible in Pages v2 and can't accessed
When dragging in components without content that call external API or fetch external scripts the component was not visible in the UI in Pages v2 UI. This has been fixed so that these components are visible in Pages v2.
Downgrade from Bundle to Digital not displaying correctly
For customers who were downgraded from Bundle to Digital subscriptions, the subscription correctly updated to Digital product in the MMA as expected. However, when “Manage Subscription” was clicked, the product shown was shows the Bundle. This has been fixed so that the correct product is shown in both the MMA and in when Manage Subscription is clicked.
(Zendesk ticket #3640)
Tax is refunded twice in Zuora Refunds
Zuora refunds were incorrectly returning the tax paid to the customer twice. This has been resolved so that the correct tax is refunded.
(Zendesk ticket #3733)
Double-barrelled last names without a hyphen appearing incorrectly
When using Limio/Zuora sync for a customer with a double- barrelled second name without a hyphen, e.g. Jane Smith Jones, the customer’s name would appear correctly in Salesforce but not in the customer-table in Limio. This has now been resolved so that the name will appear correctly in Salesforce and in the customer-table in Limio.
"Order change success" component not supporting Term
The "order change success" component crashed when cancelling a subscription with Renewal Type = Evergreen. This has been fixed so that the "order change success" component displays correctly as expected.
Quantity not supported during promo code redemption
Promo codes had a bug where customers could redeem the promo code past its quantity limit. This has now been resolved.
Normalise basket to allow for LFS-initiated Limio Commerce checkout
Previously, LFS could not initiate a Limio Commerce Shop checkout. This bug has been fixed so this is now possible.
Last updated
Was this helpful?

