> ## Documentation Index
> Fetch the complete documentation index at: https://help.mathership.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Edit Products
> Update product information in a vendor product catalog
# Edit Products
Vendors can edit products in their own product catalog.
Use this when product information changes or when an existing product needs to be corrected.
## What can be changed?
A vendor can update product details such as:
| Field | Meaning |
| -------------- | ----------------------------------------------- |
| Product name | The name shown to customers |
| Product number | The vendor article or product number |
| Packaging | The visible packaging description |
| Stock | Current stock value |
| Description | Additional product information |
| Price | Product price used for order exports and totals |
| Product image | Custom image or image URL |
The exact fields shown can depend on the user interface and serializer configuration.
## Who can update products?
Only vendors can edit products that belong to their own vendor company.
Mathership checks that:
* The vendor company exists
* The logged-in user owns the vendor company
* The product exists
* The product belongs to that vendor company
Vendors cannot edit products that belong to another vendor company.
## Updating product details
Use product editing to keep your catalog accurate.
Common changes include:
* Correcting a product name
* Updating a product number
* Changing the packaging text
* Updating stock
* Adding or changing a description
* Updating the price
* Replacing a product image
## Changing prices
Prices can be updated on the product.
If a product has a price, Mathership can use it later for order totals and exports.
| Product price | Result |
| --------------- | --------------------------------- |
| Price available | Line totals can be calculated |
| Price missing | Price can be shown as unavailable |
Missing prices do not prevent orders from being created.
## Updating stock
Stock can be updated when changing product information.
If the stock field is empty, missing, or set to null, Mathership can treat it as `0`.
Use stock values to help customers and vendors understand whether a product is currently available.
## Changing product images
When changing a product image, vendors can use:
| Option | Result |
| ----------------------- | ----------------------------------------------------------- |
| Upload a file | Replaces the current custom image |
| Enter an image URL | Uses the provided image URL |
| Automatic product image | Clears the custom image and allows automatic image handling |
If a new custom image is uploaded or a new image URL is used, the old stored image may be removed.
## Automatic product images
Automatic product image mode can be used when the product should no longer use a custom image.
When automatic image mode is selected:
* The existing custom image can be removed
* The product is marked as not using a custom image
* The image URL can be cleared
This is useful when you want Mathership to handle product images automatically again.
## Typical workflow
1. Open your vendor company
2. Go to **Products**
3. Find the product you want to edit
4. Open the product
5. Change the product information
6. Save the changes
7. Review the product in the catalog
## Example: Update a price
A vendor wants to update the price of a product.
| Step | Action |
| ---- | ---------------------- |
| 1 | Open **Products** |
| 2 | Search for the product |
| 3 | Open the product |
| 4 | Change the price |
| 5 | Save the product |
## Example: Correct packaging
A vendor notices that the packaging text is wrong.
| Step | Action |
| ---- | ---------------------------------- |
| 1 | Open the product catalog |
| 2 | Find the product |
| 3 | Update the packaging field |
| 4 | Save the product |
| 5 | Check how it appears for customers |
## Example: Replace an image
A vendor wants to use a better product image.
| Step | Action |
| ---- | ------------------------------------------- |
| 1 | Open the product |
| 2 | Upload a new image or enter a new image URL |
| 3 | Save the product |
| 4 | Check that the image is shown correctly |
## Editing or deleting?
Editing keeps the product in the catalog.
Deleting removes the product from the active catalog.
| Action | Use when |
| -------------- | --------------------------------- |
| Edit product | Product information should change |
| Delete product | Product should be removed |
## Product data or availability?
Updating product data is different from changing product availability.
| Action | Use when |
| ------------------- | ------------------------------------------------------------ |
| Edit product | Name, price, packaging, stock, description, or image changes |
| Change availability | Product should be available or not available |
## Common problems
### Product cannot be edited
Check that:
* You are logged in as a vendor
* You opened the correct vendor company
* The product belongs to this vendor company
* The product still exists
### Changes are not visible
Check that:
* The product was saved
* The product list was refreshed
* You are viewing the correct vendor company
* The field you changed is shown in the current view
### Image did not update
Check that:
* The uploaded file was accepted
* The image URL is valid
* Automatic product image mode was not selected
* The product was saved after changing the image
### Price looks wrong
Check that:
* The price was entered in the expected number format
* The product was saved
* The customer is viewing the updated product
* The order was created after the price update
Existing order items can keep the price that was stored when the order was created.
## Best practices
### Keep names consistent
Use clear product names so customers can find the correct item.
### Use product numbers carefully
Product numbers help match products during uploads and updates.
### Keep prices current
Updated prices improve order totals and exports.
### Use availability for temporary changes
If a product is temporarily out of stock, change availability instead of deleting the product.
### Review image changes
After changing an image, check how the product appears in the customer catalog.
## Related pages
Add a new product to the vendor catalog.
Remove products from the catalog.
Mark products as available or not available.
Manage product images and image sources.
Manage packaging levels for products.
Upload or update many products at once.