Articles in this section

How to Use Custom Inventory Change Reasons

Maintaining inventory accuracy in ShipHero requires documenting why every stock adjustment occurs. ShipHero records every inventory move made in the system on the Inventory Change Log and allows you to create and use custom Inventory Change Reasons to record why specific manual adjustments are made.

Custom Inventory Change Reasons provide the necessary context for manual updates, ensuring all warehouse activities remain transparent and measurable.

Creating Custom Change Reasons

Before the warehouse team can label adjustments, you must define the categories within your workflow.

  1. Go to the Inventory > Inventory Change Reasons page.
  2. Select Add a Reason (+).
  3. Define the Title (e.g., Warehouse Damage).
  4. Provide a Description to guide staff on when to select this option.
  5. Select Save.

You can also Edit or Delete existing reasons from this page. The page displays all your reasons in a table showing Title, Description, Created At, and Updated At.

Common Reason Examples Usage Context
Cycle Count Adjustment Used for corrections identified during routine stock checks.
Manufacturer Defect Used for items that arrived unsellable from the vendor.
Inbound Shipping Damage Used for items damaged during transit to the warehouse.

Application of Change Reasons

ShipHero integrates these reasons into multiple areas of the platform to ensure adjustments are documented:

  • Desktop Dashboard: Used when adding bins, editing item locations, or performing bulk inventory uploads.
  • Mobile App: Used by floor staff on the Edit Inventory screen or when adjusting stock at a picking location.

Enforcing Mandatory Reasons

To maintain data integrity, you can require a reason for every inventory change. This prevents manual updates that lack descriptive data.

  1. Go to the My Account > Settings page and select App Settings.
  2. Locate the Force user to enter a reason for every inventory change checkbox.
  3. Toggle the setting to On. The system will now block any inventory update that does not include a selected reason.
Feature State System Behavior and Requirements
Enabled
  • Users must select a reason for every manual quantity modification.
  • System validation prevents changes without a selected reason.
  • Error messages "Invalid change reason" or "Reason is required" appear if the field is empty.
  • A dropdown of defined reasons appears in all inventory change screens.
Disabled
  • Inventory changes are permitted without a selected reason.
  • The reason selection field may be hidden in specific forms.
Was this article helpful?
0 out of 1 found this helpful

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.