spree-promotions

Manage Spree Commerce promotions, rules, actions, and calculators.

4|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/spree/agent-skills --skill spree-promotions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spree-promotions
Source: https://github.com/spree/agent-skills/tree/main/skills/spree-promotions
Command: npx skills add https://github.com/spree/agent-skills --skill spree-promotions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating, managing, and applying promotions and discounts in Spree Commerce, reducing complexity and manual effort.

Core Features & Use Cases

  • Create Promotions: Generate promotions with code, dates, and usage limits.
  • Custom Rules and Actions: Design custom promotion rules and actions for specific scenarios.
  • Automated Discounts: Apply discounts programmatically to orders and line items.
  • Use Case: Automate a promotion that offers a 20% discount on orders over $100 for a limited time.

Quick Start

Create a new promotion with the code 'SUMMER20' that offers a 20% discount on orders over $100 for the next two months.

Frequently Asked Questions about spree-promotions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a promotion with coupon codes in Spree Commerce?

Creating a promotion in Spree Commerce involves defining the campaign with a code, dates, and usage limits. You then configure rules and actions to automate the application of discounts to eligible orders.

How do I apply automated discounts to orders over a certain amount in Spree?

Applying automated discounts in Spree requires setting up a promotion with a rule for a minimum order amount and an action for a percentage discount. The system programmatically applies the discount when the order meets the criteria.

Can I design custom promotion rules and actions for a Spree Commerce store?

Yes, designing custom promotion rules and actions in Spree Commerce is supported. This allows you to define specific criteria and automated discount scenarios beyond the default options for your e-commerce store.

Do I need Ruby on Rails knowledge to manage Spree Commerce promotions?

Yes, Ruby on Rails knowledge is required to manage Spree Commerce promotions effectively. Creating custom promotion rules, actions, and calculators requires understanding the framework to automate discounts programmatically.

What is the best way to automate a limited time discount in Spree?

Automating a limited time discount in Spree involves creating a promotion campaign with defined start and end dates. You pair this with a calculator to apply the discount automatically to orders within that timeframe.