Skip to content

Commit fb11f0f

Browse files
authored
docs: fixes related to troubleshooting (medusajs#14353)
1 parent fb6a6b5 commit fb11f0f

File tree

6 files changed

+52
-21
lines changed

6 files changed

+52
-21
lines changed

www/apps/resources/app/troubleshooting/_sections/other/eaddrinuse.mdx

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,12 @@ address: '::',
88
port: 9000
99
```
1010

11-
This means that there's another process running at port `9000`. You need to either:
11+
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.
1212

13-
- 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).
14-
- Terminate other processes running on port `9000`.
13+
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`:
14+
15+
```shell
16+
PORT=9001
17+
```
18+
19+
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).

www/apps/user-guide/app/orders/export/page.mdx

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,16 @@ To export orders:
4242
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.
4343
7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon.
4444

45-
<Note>
45+
---
4646

47-
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.
47+
## Troubleshooting Export Errors
4848

49-
</Note>
49+
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.
50+
51+
You can also refer to the server logs of your Medusa application to get more information about the error.
52+
53+
<Note title="Cloud User?">
54+
55+
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
56+
57+
</Note>

www/apps/user-guide/app/products/export/page.mdx

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,16 @@ To export products:
3636
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.
3737
7. Once the export is ready, click the <InlineIcon Icon={ArrowDownTray} alt="download" /> icon.
3838

39-
<Note>
39+
---
40+
41+
## Troubleshooting Export Errors
42+
43+
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.
44+
45+
You can also refer to the server logs of your Medusa application to get more information about the error.
46+
47+
<Note title="Cloud User?">
4048

41-
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.
49+
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
4250

4351
</Note>

www/apps/user-guide/app/products/import/page.mdx

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -259,12 +259,6 @@ To import products:
259259
2. To remove the uploaded file, click the <InlineIcon Icon={EllipsisHorizontal} alt="trash" /> icon, and choose Delete from the dropdown.
260260
4. Once you’re done, click the Import button.
261261

262-
<Note>
263-
264-
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.
265-
266-
</Note>
267-
268262
![Import Products Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739878759/User%20Guide/Screenshot_2025-02-18_at_1.39.01_PM_ctovne.png)
269263

270264
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:
278272

279273
The text on the import item will explain the current state of the import.
280274

281-
<Note>
275+
### Troubleshooting Import Errors
276+
277+
If the import fails, either during parsing of the CSV file or import process, make sure that:
278+
279+
1. The [storage integration](!resources!/infrastructure-modules/file) is correctly set up in your Medusa application.
280+
2. The CSV file follows the [required format](#csv-file-format).
281+
3. All IDs provided in the CSV file (such as for collections, categories, tags, sales channels, shipping profiles, etc...) exist in your Medusa application.
282+
283+
You can also refer to the server logs of your Medusa application to get more information about the error.
284+
285+
<Note title="Cloud User?">
282286

283-
If the product import fails, please contact your technical support to check the error logs.
287+
Learn more about troubleshooting in the [Logs guide](!cloud!/logs).
284288

285-
</Note>
289+
</Note>

www/apps/user-guide/app/settings/users/page.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,12 @@ To edit the user's metadata:
8080

8181
## Delete a User
8282

83+
<Note>
84+
85+
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).
86+
87+
</Note>
88+
8389
<Note type="warning">
8490

8591
Deleting a user is irreversible.

www/apps/user-guide/generated/edit-dates.mjs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,18 @@ export const generatedEditDates = {
33
"app/tips/bulk-editor/page.mdx": "2025-04-07T13:20:09.040Z",
44
"app/tips/lists/page.mdx": "2025-02-14T14:16:04.867Z",
55
"app/settings/sales-channels/page.mdx": "2025-05-30T13:31:09.754Z",
6-
"app/settings/users/page.mdx": "2025-05-30T13:31:29.991Z",
6+
"app/settings/users/page.mdx": "2025-12-18T11:37:32.952Z",
77
"app/page.mdx": "2025-02-26T14:18:27.755Z",
88
"app/settings/page.mdx": "2025-10-09T07:25:58.554Z",
9-
"app/products/export/page.mdx": "2025-07-31T14:29:30.511Z",
9+
"app/products/export/page.mdx": "2025-12-18T11:40:44.223Z",
1010
"app/settings/return-reasons/page.mdx": "2025-05-30T13:31:05.596Z",
1111
"app/settings/regions/page.mdx": "2025-05-30T13:30:59.228Z",
1212
"app/orders/page.mdx": "2025-08-26T09:21:49.782Z",
1313
"app/settings/users/invites/page.mdx": "2025-11-12T15:31:25.390Z",
1414
"app/settings/developer/page.mdx": "2025-02-25T15:11:55.392Z",
1515
"app/settings/profile/page.mdx": "2025-05-30T13:30:55.079Z",
1616
"app/settings/store/page.mdx": "2025-12-16T12:35:20.003Z",
17-
"app/products/import/page.mdx": "2025-07-31T14:29:38.743Z",
17+
"app/products/import/page.mdx": "2025-12-18T11:43:29.688Z",
1818
"app/products/categories/page.mdx": "2025-12-16T13:03:06.204Z",
1919
"app/inventory/reservations/page.mdx": "2025-05-30T13:27:25.559Z",
2020
"app/discounts/manage/page.mdx": "2024-05-03T17:36:38+03:00",
@@ -62,5 +62,5 @@ export const generatedEditDates = {
6262
"app/settings/locations-and-shipping/shipping-option-types/page.mdx": "2025-08-28T14:03:13.999Z",
6363
"app/settings/refund-reasons/page.mdx": "2025-10-09T07:29:52.837Z",
6464
"app/settings/translations/page.mdx": "2025-12-16T13:44:48.166Z",
65-
"app/orders/export/page.mdx": "2025-12-16T14:25:26.231Z"
65+
"app/orders/export/page.mdx": "2025-12-18T11:43:04.911Z"
6666
}

0 commit comments

Comments
 (0)