Actions

An action is what Shelfie does to a product. All actions are reversible — Shelfie stores the original state and can restore it with one click.

Action types

Markdown

Drops the variant price by N% (default 20%). The original price is preserved for revert.

Parameters: percent (integer, 1–95)

Best for: Quiet price drops that don't broadcast "on sale" to your storefront.

Sale badge

Drops the price by N% and sets compareAtPrice to the original. Themes that support compareAtPrice will show a strikethrough price and "On Sale" badge.

Parameters: percent (integer, 1–95)

Best for: Visible promotions on warning/danger products.

Clearance price

Aggressive markdown (default 40%) with compareAtPrice. Identical mechanics to sale badge but higher default.

Parameters: percent (integer, 1–95)

Best for: Dead stock you need to move fast.

Add tag

Adds a tag (default clearance) to the product. Doesn't change pricing — useful for theme logic, automatic collection membership, or downstream automation (e.g. Klaviyo flows).

Parameters: tag (string)

Best for: Triggering existing storefront/marketing automation without altering price.

Add to collection

Adds the product to a specified Shopify collection (typically a clearance section).

Parameters: collectionId (Shopify Collection GID)

Best for: Manually-curated clearance sections that your theme highlights.

Unpublish

Sets product status to draft. The product becomes invisible to your storefront but stays in admin and inventory.

Parameters: none

Best for: Holiday/seasonal items you'll re-enable later.

Archive

Sets product status to archived. Removed from active catalog; inventory remains.

Parameters: none

Best for: Truly dead products you're done selling.

Reverting an action

Click Revert on any product row. Shelfie undoes the action:

• Markdown / sale badge / clearance → restore original price, clear compareAtPrice
• Add tag → remove the tag (only if it was added by Shelfie)
• Add to collection → remove from the collection
• Unpublish / archive → restore status to active

After revert, the product's recoveredAmount resets to $0 and the apply timestamp is cleared, so the next Apply starts a fresh recovered-revenue tracking window.

Action vs Action Config

• Action type is a kind (e.g. markdown)
• Action config is a named instance with parameters (e.g. "Quiet 15% Drop" using markdown type at 15%)

You configure named action configs in Settings → Actions, then assign them to rules. One action config can be re-used by many rules.