Skip to main content

Availability

Product availability lets vendors control whether a product can currently be ordered by customers. Use this feature when a product is temporarily unavailable, out of stock, paused, or available again.

What it means

Availability is a status on a vendor product. It shows whether the product can currently be ordered.
StatusMeaning
AvailableCustomers can normally see and order the product
Not availableThe product should not be treated as currently orderable

Who can update it?

This status can be updated by vendor users. A vendor can only update products that belong to their own vendor company.
Vendors cannot update products from another vendor company.

When to use it

Use this setting when:
  • A product is temporarily sold out
  • A product is paused
  • A product is no longer offered for the moment
  • A seasonal product should be hidden or marked unavailable
  • A product becomes available again

How it works

Mathership checks that:
  • The user is logged in
  • The user is a vendor
  • The vendor company exists
  • The product exists
  • The product belongs to the vendor company
  • The submitted status value is valid
If the checks pass, Mathership updates the product.

Supported values

The product status supports two values:
ValueMeaning
availableProduct is available
not_availableProduct is not available
If another value is submitted, Mathership rejects the update.
The value must be either available or not_available.

Product access rules

Changes are protected by vendor ownership. This means:
  • Vendors can update their own products
  • Vendors cannot update products from another vendor
  • Customers cannot change this setting

Example: Mark a product as not available

A vendor has a product that is temporarily sold out.
StepAction
1Open the vendor product list
2Find the product
3Change the status to not available
4Save the product
The product is then marked as not currently available.

Example: Make a product available again

A product was unavailable but is now back in stock.
StepAction
1Open the product
2Change the status to available
3Save the product
Customers can then treat the product as available again.

Status and stock

Availability is separate from stock quantity.
FieldPurpose
AvailabilityShows whether the product is currently available
StockStores a numeric stock value if used
A product can have a stock value and still be marked as not available.

Status and deleted products

Marking a product as unavailable is not the same as deleting it.
ActionMeaning
Mark not availableProduct remains in the catalog but is not currently available
Delete productProduct is removed or hidden from normal product lists
Use not available for temporary pauses. Use delete only when the product should no longer be used.

Common problems

Status cannot be updated

Check that:
  • You are logged in as a vendor
  • You opened the correct vendor company
  • The product belongs to your vendor company
  • The submitted value is valid

Product is not found

Check that:
  • The product still exists
  • The product was not deleted
  • You are using the correct vendor company

Access is denied

Access is denied if the product belongs to another vendor company or the user is not a vendor.

Invalid value

Only these values are valid:
  • available
  • not_available

Best practices

Use not available for temporary issues

If a product is only temporarily unavailable, mark it as not available instead of deleting it.

Keep product status updated

Update products when they are sold out, paused, seasonal, or back in stock.

Review unavailable products regularly

Check unavailable products from time to time so products are not accidentally left inactive.

Use clear product names

Clear product names make it easier to find the right product before changing its status.

Adding Products

Add a new product to your vendor catalog.

Edit Products

Update existing product information.

Delete Products

Remove products from your vendor catalog.

Product Images

Manage product images and automatic image lookup.
Last modified on May 8, 2026