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.

Editing an action config

When you change an action config's parameters in Settings → Actions (e.g. bump markdown from 20% to 25%), already-applied products do NOT update automatically. The change only affects products applied from that point onward.

Existing applied products are flagged as Out of date in the dashboard — their Action badge turns yellow with a status dot and a tooltip explains the action's settings have changed. The row's button changes from Revert to Reapply.

Reapply runs revert + re-execute in one step, pushing the latest parameters to Shopify. You can also include out-of-date products in bulk: just use Apply Selected — drifted rows are silently reverted and re-applied alongside any not-yet-applied products in the selection.

The drift signal is also raised when:

• A rule's assigned action is swapped to a different action config
• The default action is changed and a product was applied via the catch-all

Deleting an action config

Settings → Actions → Delete is guarded. If any product currently has the action applied or queued as pending, the delete is blocked and the dialog reports how many products would be affected. Revert those products first (or reassign the rule to a different action), then retry the delete.

When the delete proceeds, Shelfie clears lastAppliedActionId and the params hash on any historical references in the same transaction so no rows are left pointing at a missing action.