docs: fixes related to troubleshooting (#14353)

This commit is contained in:
Shahed Nasser
2025-12-18 17:00:59 +02:00
committed by GitHub
parent fb6a6b52fa
commit fb11f0f272
6 changed files with 52 additions and 21 deletions

View File

@@ -8,7 +8,12 @@ address: '::',
port: 9000 port: 9000
``` ```
This means that there's another process running at port `9000`. You need to either: This means that there's another process running at port `9000`. You need to either terminate the other process or change the port used by your Medusa application.
- Change the default port used by the Medusa application. You can do that by setting the `PORT` environment variable to a new port. When you do this, make sure to change the port used in other apps that interact with your Medusa application, such as in your [admin](!docs!/learn/configurations/medusa-config#admin) or [storefront](../../../nextjs-starter/page.mdx#change-medusa-application-url). To change the default port used by the Medusa application, set the `PORT` environment variable before starting your application. For example, set it in `.env`:
- Terminate other processes running on port `9000`.
```shell
PORT=9001
```
After changing the port, make sure to change the port used in other apps that interact with your Medusa server, such as in your [admin](!docs!/learn/configurations/medusa-config#admin) or [storefront](../../../nextjs-starter/page.mdx#change-medusa-application-url).

View File

@@ -42,8 +42,16 @@ To export orders:
6. To check the export's status, click the <InlineIcon Icon={BellAlert} alt="bell" /> notifications icon in the page's header. You should see your new export loading. 6. To check the export's status, click the <InlineIcon Icon={BellAlert} alt="bell" /> notifications icon in the page's header. You should see your new export loading.
7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon. 7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon.
<Note> ---
If you face any errors or difficulties, please contact your technical support team as this could be an issue in the [storage integration](!resources!/infrastructure-modules/file) used. ## Troubleshooting Export Errors
</Note> If the export fails, either during creation of the CSV file or download, make sure that the [storage integration](!resources!/infrastructure-modules/file) is correctly set up in your Medusa application.
You can also refer to the server logs of your Medusa application to get more information about the error.
<Note title="Cloud User?">
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
</Note>

View File

@@ -36,8 +36,16 @@ To export products:
6. To check the export's status, click the <InlineIcon Icon={BellAlert} alt="bell" /> notifications icon in the page's header. You should see your new export loading. 6. To check the export's status, click the <InlineIcon Icon={BellAlert} alt="bell" /> notifications icon in the page's header. You should see your new export loading.
7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon. 7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon.
<Note> ---
If you face any errors or difficulties, please contact your technical support team as this could be an issue in the [storage integration](!resources!/infrastructure-modules/file) used. ## Troubleshooting Export Errors
If the export fails, either during creation of the CSV file or download, make sure that the [storage integration](!resources!/infrastructure-modules/file) is correctly set up in your Medusa application.
You can also refer to the server logs of your Medusa application to get more information about the error.
<Note title="Cloud User?">
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
</Note> </Note>

View File

@@ -259,12 +259,6 @@ To import products:
2. To remove the uploaded file, click the <InlineIcon Icon={EllipsisHorizontal} alt="trash" /> icon, and choose Delete from the dropdown. 2. To remove the uploaded file, click the <InlineIcon Icon={EllipsisHorizontal} alt="trash" /> icon, and choose Delete from the dropdown.
4. Once youre done, click the Import button. 4. Once youre done, click the Import button.
<Note>
If you face any errors or difficulties, please contact your technical support team as this could be an issue in the [storage integration](!resources!/infrastructure-modules/file) used.
</Note>
![Import Products Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739878759/User%20Guide/Screenshot_2025-02-18_at_1.39.01_PM_ctovne.png) ![Import Products Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739878759/User%20Guide/Screenshot_2025-02-18_at_1.39.01_PM_ctovne.png)
This starts the import process which may take some time. This starts the import process which may take some time.
@@ -278,8 +272,18 @@ To check whether the import is in progress, finished, or failed:
The text on the import item will explain the current state of the import. The text on the import item will explain the current state of the import.
<Note> ### Troubleshooting Import Errors
If the product import fails, please contact your technical support to check the error logs. If the import fails, either during parsing of the CSV file or import process, make sure that:
</Note> 1. The [storage integration](!resources!/infrastructure-modules/file) is correctly set up in your Medusa application.
2. The CSV file follows the [required format](#csv-file-format).
3. All IDs provided in the CSV file (such as for collections, categories, tags, sales channels, shipping profiles, etc...) exist in your Medusa application.
You can also refer to the server logs of your Medusa application to get more information about the error.
<Note title="Cloud User?">
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
</Note>

View File

@@ -80,6 +80,12 @@ To edit the user's metadata:
## Delete a User ## Delete a User
<Note>
This feature is available since [Medusa v2.12.0](https://github.com/medusajs/medusa/releases/tag/v2.12.0). If you don't find the option to delete a user, or user deletion doesn't work, make sure to [update your Medusa application](!docs!/learn/update).
</Note>
<Note type="warning"> <Note type="warning">
Deleting a user is irreversible. Deleting a user is irreversible.

View File

@@ -3,10 +3,10 @@ export const generatedEditDates = {
"app/tips/bulk-editor/page.mdx": "2025-04-07T13:20:09.040Z", "app/tips/bulk-editor/page.mdx": "2025-04-07T13:20:09.040Z",
"app/tips/lists/page.mdx": "2025-02-14T14:16:04.867Z", "app/tips/lists/page.mdx": "2025-02-14T14:16:04.867Z",
"app/settings/sales-channels/page.mdx": "2025-05-30T13:31:09.754Z", "app/settings/sales-channels/page.mdx": "2025-05-30T13:31:09.754Z",
"app/settings/users/page.mdx": "2025-05-30T13:31:29.991Z", "app/settings/users/page.mdx": "2025-12-18T11:37:32.952Z",
"app/page.mdx": "2025-02-26T14:18:27.755Z", "app/page.mdx": "2025-02-26T14:18:27.755Z",
"app/settings/page.mdx": "2025-10-09T07:25:58.554Z", "app/settings/page.mdx": "2025-10-09T07:25:58.554Z",
"app/products/export/page.mdx": "2025-07-31T14:29:30.511Z", "app/products/export/page.mdx": "2025-12-18T11:40:44.223Z",
"app/settings/return-reasons/page.mdx": "2025-05-30T13:31:05.596Z", "app/settings/return-reasons/page.mdx": "2025-05-30T13:31:05.596Z",
"app/settings/regions/page.mdx": "2025-05-30T13:30:59.228Z", "app/settings/regions/page.mdx": "2025-05-30T13:30:59.228Z",
"app/orders/page.mdx": "2025-08-26T09:21:49.782Z", "app/orders/page.mdx": "2025-08-26T09:21:49.782Z",
@@ -14,7 +14,7 @@ export const generatedEditDates = {
"app/settings/developer/page.mdx": "2025-02-25T15:11:55.392Z", "app/settings/developer/page.mdx": "2025-02-25T15:11:55.392Z",
"app/settings/profile/page.mdx": "2025-05-30T13:30:55.079Z", "app/settings/profile/page.mdx": "2025-05-30T13:30:55.079Z",
"app/settings/store/page.mdx": "2025-12-16T12:35:20.003Z", "app/settings/store/page.mdx": "2025-12-16T12:35:20.003Z",
"app/products/import/page.mdx": "2025-07-31T14:29:38.743Z", "app/products/import/page.mdx": "2025-12-18T11:43:29.688Z",
"app/products/categories/page.mdx": "2025-12-16T13:03:06.204Z", "app/products/categories/page.mdx": "2025-12-16T13:03:06.204Z",
"app/inventory/reservations/page.mdx": "2025-05-30T13:27:25.559Z", "app/inventory/reservations/page.mdx": "2025-05-30T13:27:25.559Z",
"app/discounts/manage/page.mdx": "2024-05-03T17:36:38+03:00", "app/discounts/manage/page.mdx": "2024-05-03T17:36:38+03:00",
@@ -62,5 +62,5 @@ export const generatedEditDates = {
"app/settings/locations-and-shipping/shipping-option-types/page.mdx": "2025-08-28T14:03:13.999Z", "app/settings/locations-and-shipping/shipping-option-types/page.mdx": "2025-08-28T14:03:13.999Z",
"app/settings/refund-reasons/page.mdx": "2025-10-09T07:29:52.837Z", "app/settings/refund-reasons/page.mdx": "2025-10-09T07:29:52.837Z",
"app/settings/translations/page.mdx": "2025-12-16T13:44:48.166Z", "app/settings/translations/page.mdx": "2025-12-16T13:44:48.166Z",
"app/orders/export/page.mdx": "2025-12-16T14:25:26.231Z" "app/orders/export/page.mdx": "2025-12-18T11:43:04.911Z"
} }