Create and Edit Promotions in the Admin Platform

This guide explains how to create and edit promotions in the Admin Platform.

Use it when you want to:

• create a one-time or subscription promotion
• generate or enter a promotion code
• configure discount rules and usage limits
• set start and end dates
• attach courses, bundles, products, or subscription plans
• update an existing promotion after it has been created

Open The Promotion Creation Page

To create a new promotion:

1. Go to Marketing > Promotions.
2. Select Create promotion.

OpenMirai then opens the promotion setup page.

Understand The Promotion Setup Page

The promotion creation page includes:

• a back button
• a section list for easier navigation
• a save bar
• a Basic Info section
• a Details section
• a Configuration section
• an Items section

Use this page when you want to build the full promotion in one flow.

Use The Save Bar

The save bar appears while you work on the form.

Use it to create the promotion after you finish reviewing the details.

After saving successfully, OpenMirai returns you to the promotions list.

Choose The Promotion Type

In the Basic Info section, use Type of promotion to choose one of these options:

• One-time purchase
• Subscription

Choose the promotion type carefully because it changes:

• which discount settings appear later
• which items you can attach
• which fields become fixed after the promotion is created

Important detail:

• if you switch between one-time and subscription while creating the promotion, OpenMirai clears selected items from the other type

Enter The Promotion Name

Use Promotion Name to enter a clear internal name for the promotion.

Choose a name that helps your team recognize the campaign quickly later.

Enter Or Generate The Promotion Code

Use Promotion Code to add the code users will redeem.

You can:

• type the code manually
• select Generate to let OpenMirai create one for you

Important detail:

• the code must use capital letters and numbers only

Add Promotion Details

In the Details section, use the Details editor to add a short description for the promotion.

Use this when you want teammates to understand the purpose of the promotion more easily from its detail page.

Choose The Usage Type

In the Configuration section, use Usage Type to decide how the promotion is used.

You can choose:

• Auto
• Manual

This setting controls whether the promotion is applied automatically or used manually with its code.

Set The Discount

Use the Discount controls to choose the discount type and amount.

You can choose:

• Percentage
• Fixed

Then enter the discount value in the field beside it.

Use percentage discounts when the offer should scale with the purchase amount.

Use fixed discounts when the promotion should reduce the price by one fixed currency amount.

Set The Start Date

Use Start Date to choose when the promotion becomes available.

OpenMirai does not let you set the start date earlier than the current day.

Set Or Remove The End Date

Use End Date when the promotion should stop automatically on a specific date and time.

This field is optional.

If you want the promotion to continue without a planned end date, leave the field empty.

If you already added an end date and want to remove it, use the clear button beside the date field.

Important detail:

• the end date cannot be earlier than the start date

Set Usage Limits

The Configuration section also includes optional usage limits:

• Total Usage Limit
• Per Customer Limit

Use these when:

• a campaign should stop after a fixed number of uses
• one customer should not be able to redeem the promotion too many times

You can leave these fields empty if you do not want to set a fixed limit.

Set Subscription Discount Duration

If the promotion type is Subscription, OpenMirai shows extra fields for Discount Duration.

You can choose:

• Once
• Repeating
• Forever

Use these options to control how long the subscription discount should continue.

Set Max Billing Cycles For Repeating Subscription Discounts

If you choose Repeating, OpenMirai also shows Max Billing Cycles.

Use this field to decide how many billing cycles should receive the discount before it stops.

Add Items To A One-Time Promotion

If the promotion type is One-time purchase, the Items section lets you attach:

• courses
• bundles
• products

Use Add Items to open the item selection dialog.

Inside the dialog, OpenMirai lets you browse available items and choose what should use the promotion.

After you apply the selection, OpenMirai shows the chosen items in the page.

Review And Remove Selected One-Time Items

Selected courses, bundles, and products appear in separate sections inside the Items area.

Use these lists to confirm that the promotion applies to the correct content or products.

Each selected item includes a Remove action.

Use it when:

• the wrong item was added
• the promotion scope has changed
• you want to narrow the campaign before saving

Add Subscription Plans To A Subscription Promotion

If the promotion type is Subscription, the Items section changes to a subscription plan picker.

Use Add Subscription Plans to open the selection dialog.

Inside the dialog, OpenMirai lets you:

• search for subscription plans
• filter by plan status
• select one or more plans

After you apply the selection, OpenMirai shows the chosen plans in a table.

Review And Remove Selected Subscription Plans

The subscription plan table shows details such as:

• plan name
• monthly price
• plan status

Use this table to check that the promotion is attached to the correct plans before you save it.

Each selected plan also includes a remove action.

If No Items Are Selected Yet

If you have not attached any items or plans yet, the Items section shows an empty state instead of a list.

Use the add button in that section to start building the promotion scope.

Create The Promotion

After reviewing the setup, use the save bar to create the promotion.

OpenMirai saves the promotion and returns you to the promotions list.

Open The Promotion Edit Page

To edit an existing promotion:

1. Go to Marketing > Promotions.
2. Open the promotion you want to change.
3. Choose Edit.

OpenMirai then opens the promotion edit page.

Understand The Edit Page

The edit page keeps the same general structure:

• Basic Info
• Details
• Configuration
• a save bar

However, once a promotion already exists, some structural settings become locked.

Understand Which Fields Become Read-Only

On the edit page, OpenMirai keeps several fields read-only so the core promotion setup cannot be changed later.

These locked fields can include:

• Type of promotion
• Promotion Code
• Usage Type
• Discount type and value
• Discount Duration for subscription promotions
• Max Billing Cycles for repeating subscription promotions

Use the edit page mainly for updating the parts of the promotion that are still allowed to change.

Update What Can Still Be Changed

On the edit page, you can still update fields such as:

• promotion name
• promotion details
• start date
• end date
• total usage limit
• per customer limit

Use this when:

• the campaign name needs revision
• the timing needs to change
• usage limits need to be tightened or relaxed
• the description needs to be clarified

Manage Attached Items After Creation

After a promotion has been created, attached items or subscription plans are managed from the promotion detail page instead of the main edit form.

Use the promotion detail page when you need to:

• add more courses, bundles, products, or plans
• remove attached items later

Save Promotion Changes

After updating the editable fields, use the save bar to save your changes.

OpenMirai then returns you to that promotion’s detail page.

If Promotions Are Restricted On Your Plan

On some plans, OpenMirai can show an upgrade prompt instead of the full promotion editing experience.

If that happens, follow the upgrade link shown on the page to review your billing and usage options.

If You Leave Before Saving

If you start creating a promotion and try to leave before saving, OpenMirai can warn you about unsaved changes.

Use this warning as a reminder to save first if you want to keep your work.

If A Field Needs Attention

If required information is missing or invalid, OpenMirai highlights the affected field so you can correct it before saving.

Common examples include:

• missing promotion name
• missing promotion code
• invalid code format
• missing discount value
• start and end dates in the wrong order
• repeating subscription discounts without a billing cycle limit