docs: fixes related to troubleshooting (#14353)
This commit is contained in:
@@ -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).
|
||||||
|
|||||||
@@ -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
|
||||||
|
|
||||||
|
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>
|
||||||
@@ -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>
|
||||||
|
|||||||
@@ -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 you’re done, click the Import button.
|
4. Once you’re 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>
|
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
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:
|
||||||
|
|
||||||
|
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>
|
</Note>
|
||||||
@@ -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.
|
||||||
|
|||||||
@@ -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"
|
||||||
}
|
}
|
||||||
Reference in New Issue
Block a user