Origami Frontend Components & Services

Readme: o-subs-card

o-subs-card is not maintained by the Origami team. This means that the Origami team will not necessarily be able to help you with support requests. The people who maintain this component may be able to offer support, but it's not guaranteed.

This component is used for showing information about various FT subscription packages.


Check out how to include Origami components in your project to get started with o-subs-card.


The subs card will expand to fill the width of its containing element, so you will need to build your own container system depending on how you want to arrange your page. An example of several subs packages together in a collection can be seen in the demos on the registry

<div class='o-subs-card__container'>
    <div class="o-subs-card" data-o-component="o-subs-card">
        <div class="o-subs-card__top">
            <div class="o-subs-card__copy-title">Subscription title</div>
            <div class="o-subs-card__charge">
                <button class="o-subs-card__select-button">Select</button>
                <div class="o-subs-card__charge__value">£XX.XX per week</div>
        <div class="o-subs-card__copy-pitch">Access to FT.com on your desktop, mobile and tablet</div>
        <div class="o-subs-card__expander">
            <div class="o-subs-card__copy-details">
                <ul class="o-subs-card__copy-benefits">
            <button class='o-subs-card__read-more'></button>


To include all o-subs-card classes use the oSubsCard mixin with no arguments:

@include oSubsCard();

To include a specific theme, pass an options argument with the themes to include:

@include oSubsCard($opts: (
    'themes': ('discount', 'b2b')


The subs card standard theme is teal. To differentiate amongst different subscription tiers, there are some additional themes which you can use with either the mixin or concrete classes:


If you're using the Build Service to get this component, you won't need to initialise your JavaScript, it should just work.

If you aren't using the Build Service, you'll need to fire an o.DOMContentLoaded event (which o-subs-card listens for) or construct an oSubsCard object.

Firing an o.DOMContentLoaded event

document.addEventListener('DOMContentLoaded', function() {
    document.dispatchEvent(new CustomEvent('o.DOMContentLoaded'));

Instantiating your own oSubsCard:

import { SubsCard } from '@financial-times/o-subs-card';

This will instantiate all subs-cards within the document. Alternatively you can pass in a HTMLElement, or String to be used as a selector to limit the scope of the instantiated subs cards to only child elements of the passed in scope.

Migration guide

State Major Version Last Minor Release Migration guide
✨ active 6 N/A migrate to v6
⚠ maintained 5 5.0.1 migrate to v5
⚠ maintained 4 4.1 migrate to v4
╳ deprecated 3 3.1 migrate to v3
╳ deprecated 2 2.4 migrate to v2
╳ deprecated 1 1.1 N/A


If you have any questions or comments about this component, or need help using it, please either raise an issue, visit #origami-support or email Origami Support.


This software is published by the Financial Times under the MIT licence.

Switch component view

GitHub: o-subs-card@6.2.2

Install o-subs-card

If using the Build Service, add o-subs-card@^6.2.2 to your script and link tags.

If using the npm package manager for a Manual Build, run npm install --save-peer "@financial-times/o-subs-card@^6.2.2".

Help & Support

o-subs-card is not supported directly by the Origami team. We make no guarantees, but will help if we can. First try contacting its maintainers at:

Slack: #next-conversion-dev
Email: conversion.tech@ft.com