Skip to main content
The card layout on the Subscription Options widget supports configuring custom descriptions for each plan. This configuration uses a custom metaobject definition in Shopify. First, you need to create the metaobject definition, then add entries for each selling plan.

​
Step 1: Create the Metaobject Definition

First, create a metaobject definition in your Shopify admin under Settings > Custom data > Metaobjects with this configuration:
  • Name: Firmhouse Selling Plan Metadata
  • Type: firmhouse_selling_plan_metadata
Then add these fields to the metaobject definition:

​
Frequency Field

  • Type: Single line text
  • Name: Frequency
  • Key: firmhouse_selling_plan_metadata.frequency
  • Description: Defines the subscription to which this metadata will be assigned (e.g., 1_month, 3_weeks)
Frequency field configuration

​
Description Field

  • Type: Rich text
  • Name: Description
  • Key: firmhouse_selling_plan_metadata.description
  • Description: The custom description that will be shown for the plan.
Description field configuration

​
Default Field

  • Type: True or false
  • Name: Default
  • Key: firmhouse_selling_plan_metadata.default
  • Description: Set this field to true to make this plan the default subscription option.
Default field configuration After adding all fields, save the definition. Complete metaobject definition

​
Step 2: Create Metaobjects for Each Plan

Now that the metaobject definition is ready, you can start adding the configuration for each plan by clicking the Add entry button on the metaobject definition page. Add entry button In the frequency field, enter the frequency configured on Firmhouse for your plan in the format <number>_<unit-in-plural-form> (e.g., 1_week, 2_months, 15_days, 1_year). To create a default description for all options without a matching metaobject, use default as the frequency field value. Metaobject entry example

​
Step 3: Add the Metaobjects to Widget Configuration

You can now assign the metaobjects to the Subscription Options configuration.

​
Steps

  1. Go to the theme editor and open the Subscription Options widget settings.
  2. Scroll down to the Card Layout Settings section.
  3. Click the Select button next to the Selling Plan Metadata field.
  4. Select all the options you have configured.
Selecting metaobjects in widget settings Selected metaobjects Once added, confirm that the descriptions appear for each option. If everything looks correct, you’re all set! Final result with custom descriptions

​
Step 4 (Optional): Translate Your Metaobject Content

If your store supports multiple languages, you can translate the metaobject content using the Translate & Adapt app.

​
Steps

  1. Go to the Metaobject translation section in the Translate & Adapt app.
  2. From the top bar, select the market and language you want to translate the content for.
  3. On the sidebar, select the metaobject you created for the widget metadata (for example, Firmhouse Selling Plan Metadata), and update the translations for each field (such as the Description field).
  4. Save your changes and test on your storefront by switching to the translated language.
Translation settings Note: Do not translate the frequency values like 2_months, 4_months, etc., otherwise the translation will not work correctly.