docs: migrated images to cloudinary from imgur (#2569)

This commit is contained in:
Shahed Nasser
2022-11-09 16:30:41 +02:00
committed by GitHub
parent 0a31ea9d43
commit 9e7e8c6d51
56 changed files with 326 additions and 328 deletions
+10 -10
View File
@@ -34,27 +34,27 @@ The first step is to create an Algolia app for your Medusa server. To create one
On the Applications page, click on the New application button at the top right.
![Click on New application button at the top right](https://i.imgur.com/WxckgS2.png)
![Click on New application button at the top right](https://res.cloudinary.com/dza7lstvk/image/upload/v1667999820/Medusa%20Docs/Algolia/WxckgS2_eygl8l.png)
In the new page that opens, optionally enter a name for the application and choose a subscription plan. You can choose the Free plan for now, but its recommended to switch to the Pay-as-you-go plan as your business grows.
![Optionally enter a name for the application and choose a subscription plan](https://i.imgur.com/jpM2EBU.png)
![Optionally enter a name for the application and choose a subscription plan](https://res.cloudinary.com/dza7lstvk/image/upload/v1667999980/Medusa%20Docs/Algolia/jpM2EBU_fui1lg.png)
Once youre done, click on the Next Step button. If you picked Pay as you go service, youll need to enter billing details before you proceed.
Then, youll be asked to pick a region for your application. Once youre done, click on Review Application Details.
![Select a region then click on Review Application Details at the bottom right](https://i.imgur.com/fahf2J2.png)
![Select a region then click on Review Application Details at the bottom right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000005/Medusa%20Docs/Algolia/fahf2J2_qgm7sa.png)
In the last step, youll see a summary of your order. If all looks good, check the checkboxes at the end of the form to indicate that you agree to the terms and conditions. Then, click on the Create Application button.
![Summary of your application's order with the terms and agreement checkboxes checked](https://i.imgur.com/PTI2Swq.png)
![Summary of your application's order with the terms and agreement checkboxes checked](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000019/Medusa%20Docs/Algolia/PTI2Swq_a1qbi5.png)
## Retrieve API Keys
To retrieve the API keys that youll use in the next sections, go to Settings, then choose API Keys in the Team and Access section.
![Click on API Keys in the Team and Access section of your settings](https://i.imgur.com/gnORibC.png)
![Click on API Keys in the Team and Access section of your settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000028/Medusa%20Docs/Algolia/gnORibC_msuur5.png)
On this page, youll find the Application ID, Search-Only API Key, and Admin API Key. Youll need the Application ID and Admin API Key for the Medusa server. As for the storefront, youll need the Application ID and Search-Only API Key.
@@ -64,7 +64,7 @@ If you have more than one application in your Algolia account, make sure your
:::
![Application ID, Search-Only API Key, and Admin API Key can be found in the API Keys page](https://i.imgur.com/i50Irki.png)
![Application ID, Search-Only API Key, and Admin API Key can be found in the API Keys page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000037/Medusa%20Docs/Algolia/i50Irki_jmtyk6.png)
## Install the Algolia Plugin
@@ -128,7 +128,7 @@ npm run start
The quickest way to test that the integration is working is by sending a `POST` request to `/store/products/search`. This endpoint accepts a `q` body parameter of the query to search for and returns in the result the products that match this query.
![Postman request send to the search endpoint that retrieves products using Algolia](https://i.imgur.com/IHeTsi7.png)
![Postman request send to the search endpoint that retrieves products using Algolia](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000054/Medusa%20Docs/Algolia/IHeTsi7_ymhb2p.png)
You can also check that the products are properly indexed by opening your Algolia dashboard and choosing Search from the left sidebar. Youll find your products that are on your Medusa server added there.
@@ -138,7 +138,7 @@ If you have more than one application on your Algolia account, make sure your
:::
![Products from the Medusa server can be seen on the Algolia dashboard](https://i.imgur.com/wkXzUH0.png)
![Products from the Medusa server can be seen on the Algolia dashboard](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000071/Medusa%20Docs/Algolia/wkXzUH0_dowyxj.png)
### Add or Update Products
@@ -211,7 +211,7 @@ To make sure the Next.js storefront properly displays the products in the search
:::
![Search pop up in the Next.js storefront](https://i.imgur.com/1f9qqK6.png)
![Search pop up in the Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000082/Medusa%20Docs/Algolia/1f9qqK6_c0z8zi.png)
## Add to Gatsby and React-Based Storefronts
@@ -325,7 +325,7 @@ And add the `Search` component in the returned JSX before `RegionPopover`:
If you run your Gatsby storefront while the Medusa server is running, you should find a search bar in the header of the page. Try entering a query to search through the products in your store.
![Search bar in the Gatsby storefront](https://i.imgur.com/INtlcIo.png)
![Search bar in the Gatsby storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000097/Medusa%20Docs/Algolia/INtlcIo_jlh16x.png)
## Whats Next
@@ -118,31 +118,31 @@ This runs the Contentful migration in that file and makes the necessary changes
To check if the above migration worked, in your Contentful Space dashboard go to Content Models from the navigation bar. You should see the new content model Rich Text.
![Rich Text can be found among content models](https://i.imgur.com/W5WzcTG.png)
![Rich Text can be found among content models](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001241/Medusa%20Docs/Contentful/W5WzcTG_vau6c9.png)
The above migration also allows you to add Rich Text content to pages. To test this out, go to Content from the navigation bar and choose Page in the select field next to the search bar. This shows the available pages in your Contentful Space.
![Filter content to only show pages by choosing Page in the Content Type select field](https://i.imgur.com/ht87z4e.png)
![Filter content to only show pages by choosing Page in the Content Type select field](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001251/Medusa%20Docs/Contentful/ht87z4e_gmbk6c.png)
Choose one of the pages. For example, the About page. Then, scroll down to the Add content button. If you click on it, you should be able to choose Rich Text under New Content.
![Click on add content and choose from the dropdown Rich Text](https://i.imgur.com/pJ5yM0m.png)
![Click on add content and choose from the dropdown Rich Text](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001261/Medusa%20Docs/Contentful/pJ5yM0m_dfb7vp.png)
Click on Rich Text and a new form will open to create new Rich Text content. It has the same fields that you defined in the migration file.
![The Rich Text form is filled with data](https://i.imgur.com/lAglhc9.png)
![The Rich Text form is filled with data](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001271/Medusa%20Docs/Contentful/lAglhc9_ejfs2i.png)
After adding the content you want, click on the Publish button on the right then go back to the About page editor.
![Click on the Publish button at the right](https://i.imgur.com/oYpQKsc.png)
![Click on the Publish button at the right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001281/Medusa%20Docs/Contentful/oYpQKsc_piobfk.png)
Similarly, in the About page editor, click on the Publish Changes button on the right to view these changes later in the storefront.
![Click on the Publish changes button at the right](https://i.imgur.com/DIMo3hd.png)
![Click on the Publish changes button at the right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001296/Medusa%20Docs/Contentful/DIMo3hd_ylxkr3.png)
Similarly, you can add Rich Text content to any product page.
![A rich text content is added to a product](https://i.imgur.com/wgI8mEB.png)
![A rich text content is added to a product](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001305/Medusa%20Docs/Contentful/wgI8mEB_wbukpd.png)
## Render New Content Models in the Storefront
@@ -238,7 +238,7 @@ npm run start
This runs the Gatsby storefront on `localhost:8000`. Go to the storefront in your browser and open the About page. You should see the Rich Text content you added.
![Rich Text content you added to the about page should be visible now](https://i.imgur.com/aQAY9Vz.png)
![Rich Text content you added to the about page should be visible now](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001320/Medusa%20Docs/Contentful/aQAY9Vz_yw4eop.png)
### Render Component in a Product Page
@@ -306,7 +306,7 @@ This loops over `contentModules` and if the type of the content is Rich Text, it
Restart the Gatsby storefront then open a product that you added Rich Text content to. You should see the Rich Text component at the end of the page.
![Rich Text content you added to the product should be visible at the end of the page](https://i.imgur.com/LGiVMxx.png)
![Rich Text content you added to the product should be visible at the end of the page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001342/Medusa%20Docs/Contentful/LGiVMxx_rqsr2l.png)
## Whats Next
+15 -15
View File
@@ -52,15 +52,15 @@ Set the value for `CONTENTFUL_ENV` to `master`.
To retrieve the value of `CONTENTFUL_SPACE_ID`, go to your [Contentful Space dashboard](https://app.contentful.com/). Then, choose Settings in the navigation bar and select API keys from the dropdown.
![Click on Settings then select API keys from the dropdown](https://i.imgur.com/hvp6zo5.png)
![Click on Settings then select API keys from the dropdown](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001360/Medusa%20Docs/Contentful/hvp6zo5_uaqtmi.png)
On the APIs page, click Add API Key.
![Click on the Add API Key button](https://i.imgur.com/KlH2BDg.png)
![Click on the Add API Key button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001375/Medusa%20Docs/Contentful/KlH2BDg_fiqd80.png)
In the form, enter a name for the API key and click Save.
![A form with the name of API key entered](https://i.imgur.com/hOG1RqM.png)
![A form with the name of API key entered](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001385/Medusa%20Docs/Contentful/hOG1RqM_tmctae.png)
Then, copy the value of Space ID and set it as the value of `CONTENTFUL_SPACE_ID`.
@@ -68,11 +68,11 @@ Then, copy the value of Space ID and set it as the value of `CONTENTFUL_SPACE_ID
Go back to the API Keys page and click on the Content management tokens tab.
![API Keys page with Content management tokens tab opened](https://i.imgur.com/7nWx1xk.png)
![API Keys page with Content management tokens tab opened](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001394/Medusa%20Docs/Contentful/7nWx1xk_co8ykw.png)
Click on Generate personal token. A pop-up will open where you have to enter a name for the token.
![Pop up model for Personal Access Token with token name entered](https://i.imgur.com/y6R81pH.png)
![Pop up model for Personal Access Token with token name entered](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001403/Medusa%20Docs/Contentful/y6R81pH_yhbg1u.png)
Once you click Generate, a personal access token will be generated. Use it to set the value of `CONTENTFUL_ACCESS_TOKEN`.
@@ -141,7 +141,7 @@ npm run migrate:contentful
Once this command finishes executing, in your Contentful Space dashboard click on Content Model in the navigation bar. You should see a list of new content models added.
![Content Model page filled with new content models](https://i.imgur.com/ZDJPNkr.png)
![Content Model page filled with new content models](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001419/Medusa%20Docs/Contentful/ZDJPNkr_avr7gy.png)
### Seed Content to Contentful
@@ -155,7 +155,7 @@ npm run seed:contentful
After this command finishes running, in your Contentful Space dashboard click on Content in the navigation bar. You should see a list of new content added.
![Content page filled with new content](https://i.imgur.com/bfgFxPg.png)
![Content page filled with new content](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001429/Medusa%20Docs/Contentful/bfgFxPg_jb4zok.png)
### (Optional) Seed Medusa Database
@@ -177,7 +177,7 @@ npm run start
If you seeded the database with demo data, you should see that events related to the products are triggered.
![Seed the database](https://i.imgur.com/ci4accp.png)
![Seed the database](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001440/Medusa%20Docs/Contentful/ci4accp_okaro3.png)
The Contentful integration ensures a two-way sync between the Medusa server and Contentful. So, when new products are added to Medusa, these products will be added to your Contentful Space as well.
@@ -195,7 +195,7 @@ To do that, open your Contentful Space Dashboard and click on Content in the Nav
Click on the checkbox at the top of the table to select all products then click Publish to publish these products.
![Select all products' checkboxes and click the publish button](https://i.imgur.com/3NrH5tJ.png)
![Select all products' checkboxes and click the publish button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001452/Medusa%20Docs/Contentful/3NrH5tJ_f16iym.png)
### Added Featured Products
@@ -203,19 +203,19 @@ On the homepage of the storefront, theres a featured products tile that shows
To do that, open your Contentful Space Dashboard and click on Content in the Navigation bar. Make sure the select field next to the search bar is set to Any and search for Featured Products. You should find one content of the type Tile Section.
![Search for the featured products tile section](https://i.imgur.com/2gS0ozY.png)
![Search for the featured products tile section](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001462/Medusa%20Docs/Contentful/2gS0ozY_b2tpsb.png)
Click on it. You should find on the page an empty Tiles section where you can add tiles and products.
![On the content's page find the empty tiles section](https://i.imgur.com/inuN1OB.png)
![On the content's page find the empty tiles section](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001472/Medusa%20Docs/Contentful/inuN1OB_ipiszl.png)
Click on Add content then on Add existing content and pick some of the products you want to show on the homepage.
![Add at least 1 product as a tile](https://i.imgur.com/N5m4LbF.png)
![Add at least 1 product as a tile](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001500/Medusa%20Docs/Contentful/N5m4LbF_fb97tm.png)
Once youre done adding products, click on Publish changes in the right sidebar.
![Click on the publish changes button on the right](https://i.imgur.com/URNpkXq.png)
![Click on the publish changes button on the right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001508/Medusa%20Docs/Contentful/URNpkXq_cb5ppp.png)
## Setup Gatsby Storefront
@@ -250,7 +250,7 @@ To retrieve the value of `CONTENTFUL_ACCESS_TOKEN`, on your Contentful Space das
You should find the field "Content Delivery API - access token”. Copy its value and set it as the value of `CONTENTFUL_ACCESS_TOKEN`.
![Copy the value of the Content Delivery API access token](https://i.imgur.com/a7dl7DI.png)
![Copy the value of the Content Delivery API access token](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001522/Medusa%20Docs/Contentful/a7dl7DI_mziogm.png)
### Start Storefront
@@ -262,7 +262,7 @@ npm run start
This starts the storefront at `localhost:8000`. Open it in your browser and you should see on the homepage the Featured Product section with the products you chose on Contentful.
![The storefront with the featured products section](https://i.imgur.com/f6xwYbS.png)
![The storefront with the featured products section](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001537/Medusa%20Docs/Contentful/f6xwYbS_w1v993.png)
## Make Changes to Content
+3 -3
View File
@@ -80,11 +80,11 @@ Try sending a `POST` request to `/mailchimp/subscribe` with the following JSON b
If the subscription is successful, a `200` response code will be returned with `OK` message.
![Postman](https://i.imgur.com/tpr7uCF.png)
![Postman](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000185/Medusa%20Docs/Mailchimp/tpr7uCF_g4rymn.png)
If you check your Mailchimp dashboard, you should find the email added to your Audience list.
![Email Added](https://i.imgur.com/ALz6WUq.png)
![Email Added](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000199/Medusa%20Docs/Mailchimp/ALz6WUq_e4mkcs.png)
### With Additional Data
@@ -173,7 +173,7 @@ export default function NewsletterForm() {
This will result in a subscription form similar to the following:
![Subscription Form](https://i.imgur.com/JHIFEwe.png)
![Subscription Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000210/Medusa%20Docs/Mailchimp/JHIFEwe_fu4rkv.png)
If you try entering an email and clicking Subscribe, the email will be subscribed to your Mailchimp newsletter successfully.
+4 -4
View File
@@ -89,11 +89,11 @@ npm run start
The quickest way to test that the integration is working is by sending a `POST` request to `/store/products/search`. This endpoint accepts a `q` body parameter of the query to search for and returns in the result the products that match this query.
![Postman request to search endpoint that shows results returned from the search engine](https://i.imgur.com/RCGquxU.png)
![Postman request to search endpoint that shows results returned from the search engine](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000265/Medusa%20Docs/MeiliSearch/RCGquxU_um3dvn.png)
You can also check that the products are properly indexed by opening the MeiliSearch host URL in your browser, which is `http://127.0.0.1:7700/` by default. Youll find your products that are on your Medusa server added there.
![MeiliSearch dashboard showing products from the Medusa server indexed](https://i.imgur.com/5sk3jyP.png)
![MeiliSearch dashboard showing products from the Medusa server indexed](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000277/Medusa%20Docs/MeiliSearch/5sk3jyP_i3swkn.png)
### Add or Update Products
@@ -170,7 +170,7 @@ To make sure the Next.js storefront properly displays the products in the search
:::
![Search Result on Next.js storefront](https://i.imgur.com/gQVWvH2.png)
![Search Result on Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000298/Medusa%20Docs/MeiliSearch/gQVWvH2_datei5.png)
### Add to Gatsby and React-Based Storefronts
@@ -284,7 +284,7 @@ And add the `Search` component in the returned JSX before `RegionPopover`:
If you run your Gatsby storefront while the Medusa server and the MeiliSearch instance are running, you should find a search bar in the header of the page. Try entering a query to search through the products in your store.
![Search box in the header of the storefront](https://i.imgur.com/ZkRgF2h.png)
![Search box in the header of the storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000317/Medusa%20Docs/MeiliSearch/ZkRgF2h_ytnpv9.png)
## Whats Next
+8 -8
View File
@@ -32,19 +32,19 @@ minio server ~/minio --console-address :9090 --address :9001
After installing MinIO and logging into the Console, click on “Create Bucket” to create a new bucket that will store the files of your Medusa server.
![Create Bucket](https://i.imgur.com/PwLldKt.png)
![Create Bucket](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000345/Medusa%20Docs/MinIO/PwLldKt_vm4r6d.png)
Then, in the form, enter a name for the bucket and click on Create Bucket. By MinIOs requirement, the name can only consist of lower case characters, numbers, dots (`.`), and hyphens (`-`).
![Bucket Info](https://i.imgur.com/UB477rl.png)
![Bucket Info](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000356/Medusa%20Docs/MinIO/UB477rl_opdmzj.png)
After creating the bucket, click on the cog icon at the top right to configure the bucket.
![Configure Bucket](https://i.imgur.com/0pB8RIM.png)
![Configure Bucket](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000369/Medusa%20Docs/MinIO/0pB8RIM_bxo20d.png)
Then, click on the edit icon next to Access Policy. This will open a pop-up.
![Access Policy](https://i.imgur.com/qo3QQz4.png)
![Access Policy](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000379/Medusa%20Docs/MinIO/qo3QQz4_asdtgb.png)
In the pop-up, change the selected value to “public” and click Set.
@@ -58,15 +58,15 @@ Changing the Access Policy to public will allow anyone to access your bucket. Av
From the sidebar of your MinIO console, click on Identity then Service Accounts.
![Service Accounts Sidebar](https://i.imgur.com/CkTbrEc.png)
![Service Accounts Sidebar](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000392/Medusa%20Docs/MinIO/CkTbrEc_ni2hlz.png)
Then, click on Create Service Account.
![Create Service Account](https://i.imgur.com/a000HQf.png)
![Create Service Account](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000403/Medusa%20Docs/MinIO/a000HQf_noszz2.png)
This will generate a random Access Key and Secret Key for you.
![Generated Keys](https://i.imgur.com/my4c7zU.png)
![Generated Keys](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000415/Medusa%20Docs/MinIO/my4c7zU_yyw6fw.png)
Click on Create. A pop-up will then show the value for your Access Key and Secret Key. Copy them to use in the next section.
@@ -119,7 +119,7 @@ If you have multiple storage plugins configured, the last plugin declared in the
Run your Medusa server alongside the [Medusa Admin](../admin/quickstart.md) to try out your new file service. Upon editing or creating products, you can now upload thumbnails and images, that are stored in a MinIO server.
![Image Uploaded on Admin](https://i.imgur.com/alabX2i.png)
![Image Uploaded on Admin](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000429/Medusa%20Docs/MinIO/alabX2i_dzg2mh.png)
## Private Buckets
+4 -4
View File
@@ -127,7 +127,7 @@ Make sure to replace `<YOUR_CLIENT_ID>` with your PayPal Client ID.
Now, if you run your Medusa server and your storefront, on checkout youll be able to use PayPal].
![PayPal Button](https://i.imgur.com/F8OvsOJ.png)
![PayPal Button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000463/Medusa%20Docs/PayPal/F8OvsOJ_v3ctol.png)
You can test out the payment with PayPal using your sandbox account.
@@ -276,7 +276,7 @@ Thats all you need to integrate PayPal into the Gatsby storefront.
Now, start the Medusa server and the Gatsby storefront server. Try adding an item into the cart and proceeding to checkout. When you reach the payment step, you should see the PayPal button.
![PayPal Button](https://i.imgur.com/SMLrptP.png)
![PayPal Button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000477/Medusa%20Docs/PayPal/SMLrptP_g6b22m.png)
You can test out the payment with PayPal using your sandbox account.
@@ -382,13 +382,13 @@ You can then import this component where you want to show it in your storefront.
If you run the Medusa server and the storefront server, you should see the PayPal button on checkout.
![PayPal Button](https://i.imgur.com/PsibgPY.png)
![PayPal Button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000492/Medusa%20Docs/PayPal/PsibgPY_xtqdli.png)
## Capture Payments
After the customer places an order, you can see the order on the admin panel. In the payment information under the “Payment” section, you should see a “Capture” button.
![Capture Payment](https://i.imgur.com/Mx357yY.png)
![Capture Payment](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000502/Medusa%20Docs/PayPal/Mx357yY_xsandw.png)
Clicking this button lets you capture the payment for an order. You can also refund payments if an order has captured payments.
+8 -8
View File
@@ -22,23 +22,23 @@ You need to [create an AWS account](https://console.aws.amazon.com/console/home?
On your AWS Console, search for S3 in the search box at the top. Then, choose the first result you see which should be S3 under the Services category.
![Enter S3 in the search box and choose S3 from the result in the Services category](https://i.imgur.com/wuPTfQ8.png)
![Enter S3 in the search box and choose S3 from the result in the Services category](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000547/Medusa%20Docs/S3/wuPTfQ8_bzbm8n.png)
Then, on the new page that opens, click on Create Bucket button at the top right of the Buckets table.
![Click on the Create bucket button](https://i.imgur.com/h95D38T.png)
![Click on the Create bucket button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000527/Medusa%20Docs/S3/h95D38T_gptwpr.png)
The Create Bucket form will open. In the General Configuration section enter a name for the bucket and choose a region for the bucket. Both of the values of these fields are important as youll use them throughout the documentation.
![Enter bucket name and choose region in the General Configuration section](https://i.imgur.com/wlxUU8I.png)
![Enter bucket name and choose region in the General Configuration section](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000559/Medusa%20Docs/S3/wlxUU8I_m4ngqd.png)
Next, in the Object Ownership section, choose ACLs enabled. Then, two radio buttons will show below it. Choose Bucket owner preferred.
![In the Object Ownership section choose ACLs enabled, then choose Bucket owner preferred for the Object ownership field](https://i.imgur.com/ChUXQPt.png)
![In the Object Ownership section choose ACLs enabled, then choose Bucket owner preferred for the Object ownership field](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000572/Medusa%20Docs/S3/ChUXQPt_eg8mn1.png)
Then, in the “Block Public Access settings for this bucket” section, uncheck the “Block all public access” checkbox. This shows a warning message at the bottom of the section with another checkbox. Check the checkbox to ensure you understand that objects in the bucket are publicly accessible.
![Uncheck Block all public access and all fields under it, and check the checkbox field "I acknowledge that the current settings might result in this bucket and the objects within becoming public"](https://i.imgur.com/abHquFh.png)
![Uncheck Block all public access and all fields under it, and check the checkbox field "I acknowledge that the current settings might result in this bucket and the objects within becoming public"](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000586/Medusa%20Docs/S3/abHquFh_wypfbx.png)
You can leave the rest of the fields in the form as is and scroll down to the end of the page. Then, click on the Create Bucket button.
@@ -46,7 +46,7 @@ You can leave the rest of the fields in the form as is and scroll down to the en
On the page of the bucket you just created, click on the Permissions tab. Then, scroll down until you find the Bucket policy section. Click on Edit in that section.
![Find the bucket policy section which should be empty and click on the Edit button](https://i.imgur.com/I6BBLwv.png)
![Find the bucket policy section which should be empty and click on the Edit button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000607/Medusa%20Docs/S3/I6BBLwv_zoknft.png)
In the Edit Bucket Policy page, enter the following in the field:
@@ -142,11 +142,11 @@ Then, you can either test the plugin using the [REST APIs](https://docs.medusajs
On the Medusa Admin, create a new product and, in the Images section, upload an image then click Save. If the integration was successful, the product image will be uploaded successfully.
![An image is successfully uploaded on the Medusa Admin](https://i.imgur.com/zPC9qFH.png)
![An image is successfully uploaded on the Medusa Admin](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000619/Medusa%20Docs/S3/zPC9qFH_dgqf76.png)
You can also check that the image was uploaded on the S3 buckets page.
![Image is now available in the S3 Bucket](https://i.imgur.com/NJZ5bP8.png)
![Image is now available in the S3 Bucket](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000630/Medusa%20Docs/S3/NJZ5bP8_ovv9rc.png)
## Next.js Storefront Configuration
+9 -9
View File
@@ -52,23 +52,23 @@ You need to [create a Segment account](https://app.segment.com/signup/) to follo
On your Segment dashboard, choose Catalog from the sidebar under Connections.
![Under Connections in the sidebar choose Catalog](https://i.imgur.com/rAeJkP3.png)
![Under Connections in the sidebar choose Catalog](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000661/Medusa%20Docs/Segment/rAeJkP3_ybyutz.png)
Then, in the catalog list find the Server category and choose Node.js from the list.
![Choose Node.js under the Server category](https://i.imgur.com/6RxQbW6.png)
![Choose Node.js under the Server category](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000672/Medusa%20Docs/Segment/6RxQbW6_wjphte.png)
This opens a new side menu. In the side menu, click on Add Source.
![Click on Add Source in the side menu showing information about the Node.js source](https://i.imgur.com/0VZJnpd.png)
![Click on Add Source in the side menu showing information about the Node.js source](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000683/Medusa%20Docs/Segment/0VZJnpd_ehagat.png)
This opens a new page to create a Node.js source. Enter the name of the source then click Add Source.
![Enter a name under the Name field then click on the Add Source button](https://i.imgur.com/u2hzkB5.png)
![Enter a name under the Name field then click on the Add Source button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000693/Medusa%20Docs/Segment/u2hzkB5_t59yhj.png)
On the new source dashboard, you should find a Write Key. Youll use this key in the next section after you install the Segment plugin on your Medusa server.
![The Write Key is available on the new source's page](https://i.imgur.com/OTJVsz7.png)
![The Write Key is available on the new source's page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000708/Medusa%20Docs/Segment/OTJVsz7_v95qla.png)
### Optional: Add Destination
@@ -76,11 +76,11 @@ After you create the Segment source, you can add destinations. This is where the
To add a destination, on the same Segment source page, click on Add Destination in the Destinations section.
![Click on the Add Destination button on the source page](https://i.imgur.com/FrKlUxh.png)
![Click on the Add Destination button on the source page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000718/Medusa%20Docs/Segment/FrKlUxh_zlnkww.png)
You can then choose from a list of destinations such as Google Universal Analytics or Facebook Pixel.
![List of some of the available destinations in Segment's catalog](https://i.imgur.com/y2YnPUh.png)
![List of some of the available destinations in Segment's catalog](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000730/Medusa%20Docs/Segment/y2YnPUh_mgfqdo.png)
The process of integrating each destination is different, so you must follow the steps detailed in Segment for each destination you choose.
@@ -126,7 +126,7 @@ Then, try triggering one of the [mentioned events earlier in this document](#eve
After you place an order, on the Segment source that you created, click on the Debugger tab. You should see at least one event triggered for each order you place. If you click on the event, you can see the order details are passed to the event.
![The order completed event is recorded on the Segment source](https://i.imgur.com/LQVJTGg.png)
![The order completed event is recorded on the Segment source](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000743/Medusa%20Docs/Segment/LQVJTGg_i5jyge.png)
If you added a destination, you can also check your destination to make sure the data is reflected there.
@@ -183,7 +183,7 @@ The `SegmentServer` also provides the method `identify` to tie a user to their a
After adding the above subscriber, run your server again if it isnt running and create a customer using the REST APIs or one of the Medusa storefronts. If you check the Debugger in your Segment source, you should see a new event “Customer Created” tracked. If you click on it, youll see the data you passed to the `track` method.
![The customer created event is recoreded on the Segment source](https://i.imgur.com/4LD41xE.png)
![The customer created event is recoreded on the Segment source](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000759/Medusa%20Docs/Segment/4LD41xE_qungdw.png)
## Whats Next
+1 -1
View File
@@ -3959,7 +3959,7 @@ If you dont have a storefront installed, check out the [Gatsby](../starters/g
You can also track analytics related to emails sent from the SendGrid dashboard.
![SendGrid Analytics](https://i.imgur.com/X01LigH.png)
![SendGrid Analytics](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000788/Medusa%20Docs/SendGrid/X01LigH_mxmtbn.png)
## Whats Next
+4 -4
View File
@@ -41,7 +41,7 @@ The first step is to create a Slack app. This app will be connected to your work
Go to [Slack API](https://api.slack.com/) and click Create app. This will take you to a new page with a pop-up. In the pop-up, choose From scratch.
![Create Slack App](https://i.imgur.com/liVfwF8.png)
![Create Slack App](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000844/Medusa%20Docs/Slack/liVfwF8_ryzly3.png)
Youll then need to enter some info like the App name and the workspace it will be connected to. Once youre done, the app will be created.
@@ -49,17 +49,17 @@ Youll then need to enter some info like the App name and the workspace it wil
To activate Incoming Webhooks, choose Features > Incoming Webhooks from the sidebar. At first, it will be disabled so make sure to enable it by switching the toggle.
![Incoming Webhooks](https://i.imgur.com/5Y0nv4p.png)
![Incoming Webhooks](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000856/Medusa%20Docs/Slack/5Y0nv4p_mugzkb.png)
### Add New Webhook
After activating Incoming Webhooks, on the same page scroll down and click on the Add New Webhook to Workspace button.
![Add New Webhook](https://i.imgur.com/sejdIqH.png)
![Add New Webhook](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000867/Medusa%20Docs/Slack/sejdIqH_wyqgs5.png)
After that, choose the channel to send the notifications to. You can also choose a DM to send the notifications to. Once youre done click Allow.
![Choose channel or DM](https://i.imgur.com/Zw3f5uF.png)
![Choose channel or DM](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000882/Medusa%20Docs/Slack/Zw3f5uF_hljfpr.png)
This will create a new Webhook with a URL which you can see in the table at the end of the Incoming Webhooks page. Copy the URL as youll use it in the next section.
+10 -10
View File
@@ -28,15 +28,15 @@ You need to [create a DigitalOcean account](https://cloud.digitalocean.com/regi
In your DigitalOcean account, click on the Create button at the top right, then choose Spaces from the dropdown.
![Click on the green Create button at the top right, then choose Spaces in the dropdown](https://i.imgur.com/AQqMRoJ.png)
![Click on the green Create button at the top right, then choose Spaces in the dropdown](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000907/Medusa%20Docs/Spaces/AQqMRoJ_uhkywh.png)
In the Create a Space form, you can choose any of the regions listed. You can alternatively leave all settings as they are and scroll down to the Finalize and Create section.
![The Space form can be left as is and move towards the Finalize and Create section](https://i.imgur.com/ipsIqoA.png)
![The Space form can be left as is and move towards the Finalize and Create section](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000929/Medusa%20Docs/Spaces/ipsIqoA_zeyfkf.png)
In the Finalize and Create section, enter a name for the field “Choose a unique name”. Youll use this name later in the integration with Medusa. Also, select the project you want to add the new Space to.
![Enter a name for the Space in the Choose a unique name field](https://i.imgur.com/NhlRX0h.png)
![Enter a name for the Space in the Choose a unique name field](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000949/Medusa%20Docs/Spaces/NhlRX0h_ptdhpk.png)
Once youre done, click on the Create a Space button. This creates the Space and redirects you to the Spaces page.
@@ -44,15 +44,15 @@ Once youre done, click on the Create a Space button. This creates the Space a
Choose API from the bottom of the sidebar.
![Choose API from the bottom of the sidebar.](https://i.imgur.com/6zNoDOW.png)
![Choose API from the bottom of the sidebar.](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000964/Medusa%20Docs/Spaces/6zNoDOW_tqbeqv.png)
This opens the Application & API page. Scroll down to Spaces Access Keys and click the Generate New Key button.
![In the Spaces access keys section, click the Generate New Key button](https://i.imgur.com/NUocdgh.png)
![In the Spaces access keys section, click the Generate New Key button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000977/Medusa%20Docs/Spaces/NUocdgh_doi0dq.png)
This shows a table with the Name field editable. Enter a name for the Access Keys and click on the checkmark button to save and generate the Spaces access keys.
![Enter a name for the Space access key in the field under the Name column](https://i.imgur.com/ihJBx0T.png)
![Enter a name for the Space access key in the field under the Name column](https://res.cloudinary.com/dza7lstvk/image/upload/v1668000987/Medusa%20Docs/Spaces/ihJBx0T_xfe4rh.png)
Then, two keys will be available under the Key column of the table. The first one is the Access Key ID and the second is the Secret Access Key. Copy both as youll use them later.
@@ -84,12 +84,12 @@ Where:
1. `<YOUR_SPACE_URL>` is the URL of your Space which you can find on the Spaces page below the Spaces name.
![The URL is available under the Space's name on the Space's page](https://i.imgur.com/cA3vkvh.png)
![The URL is available under the Space's name on the Space's page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001004/Medusa%20Docs/Spaces/cA3vkvh_maixr0.png)
2. `<YOUR_SPACE_NAME>` is the name of your Space.
3. `<YOUR_SPACE_ENDPOINT>` is your Spaces endpoint which can be found by going to your Spaces page, clicking on the Settings tab, and scrolling to the Endpoint section.
![Endpoint can be found on the Settings tab in the Space's page](https://i.imgur.com/CnvLr6R.png)
![Endpoint can be found on the Settings tab in the Space's page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001017/Medusa%20Docs/Spaces/CnvLr6R_tudlhu.png)
4. `<YOUR_ACCESS_KEY_ID>` and `<YOUR_SECRET_ACCESS_KEY>` are the keys you created in the previous section.
@@ -129,11 +129,11 @@ Then, you can either test the plugin using the [REST APIs](https://docs.medusaj
On the Medusa Admin, create a new product and, in the Images section, upload an image then click Save. If the integration was successful, the product image will be uploaded successfully.
![Image successfully uploaded on Medusa's admin](https://i.imgur.com/oTi4jIw.png)
![Image successfully uploaded on Medusa's admin](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001039/Medusa%20Docs/Spaces/oTi4jIw_c6vefa.png)
You can also check that the image was uploaded on the Spaces page.
![Image can be seen on the Space's page on DigitalOcean](https://i.imgur.com/BexmRkg.png)
![Image can be seen on the Space's page on DigitalOcean](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001050/Medusa%20Docs/Spaces/BexmRkg_gimk1d.png)
## Next.js Storefront Configuration
+4 -4
View File
@@ -36,7 +36,7 @@ This creates the Strapi project in the directory `strapi-medusa`.
Once the installation is finished, the Strapi development server will run on `localhost:1337`. A new page will also open in your default browser to create a new admin user and log in.
![Create User Form in Strapi](https://i.imgur.com/9pFE1Ij.png)
![Create User Form in Strapi](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001083/Medusa%20Docs/Strapi/9pFE1Ij_h2dicv.png)
Once you log in, you can access the Strapi dashboard.
@@ -44,11 +44,11 @@ Once you log in, you can access the Strapi dashboard.
The Strapi plugin in Medusa requires the credentials of a Strapi user. To create a new user, go to Content Manager, then choose User under Collection Types.
![Showing the users under Content Manager](https://i.imgur.com/YyGJPUf.png)
![Showing the users under Content Manager](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001096/Medusa%20Docs/Strapi/YyGJPUf_mr5sx7.png)
Click on the Create new entry button at the top right. This opens a new form to enter the users details.
![Create User Form on Strapi](https://i.imgur.com/mdMhSlV.png)
![Create User Form on Strapi](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001105/Medusa%20Docs/Strapi/mdMhSlV_vy7ygv.png)
Enter the users username, email, and password. Once youre done, click on the Save button at the top right.
@@ -58,7 +58,7 @@ By default, created users have the “Authenticated” role. Before you start us
On your Strapi dashboard, go to Settings → Roles → Authenticated. Then, under the Permissions section, expand the accordion of each content model type and check the Select All checkbox.
![An example of modifying permissions on the Product content type](https://i.imgur.com/QgckXqS.png)
![An example of modifying permissions on the Product content type](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001116/Medusa%20Docs/Strapi/QgckXqS_wlyxe8.png)
Once youre done, click the Save button at the top right.
+4 -4
View File
@@ -131,7 +131,7 @@ Make sure to replace `<YOUR_PUBLISHABLE_KEY>` with your Stripe Publishable Key.
Now, if you run your Medusa server and your storefront, on checkout youll be able to use Stripe.
![Next.js Stripe Form](https://i.imgur.com/h5mWdJT.png)
![Next.js Stripe Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001145/Medusa%20Docs/Stripe/h5mWdJT_n1bktt.png)
### Add to Gatsby Storefront
@@ -151,7 +151,7 @@ You might find this environment variable already available so you can just repla
Now, if you run your Medusa server and your storefront, on checkout youll be able to use Stripe.
![Gatsby Stripe Form](https://i.imgur.com/1XvW776.png)
![Gatsby Stripe Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001172/Medusa%20Docs/Stripe/1XvW776_omosuz.png)
### Add to Custom Storefront
@@ -344,13 +344,13 @@ Once the promise resolves you can handle the errors, if there are any. If not, y
If you run your server and storefront now, youll see the Stripe UI element and youll be able to make orders.
![Stripe Form](https://i.imgur.com/NOi8THw.png)
![Stripe Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001190/Medusa%20Docs/Stripe/NOi8THw_xv3zsx.png)
## Capture Payments
After the customer places an order, youll be able to see the order on the admin panel. In the payment information under the “Payment” section, you should see a “Capture” button.
![Capture Payment](https://i.imgur.com/Iz55PVZ.png)
![Capture Payment](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001205/Medusa%20Docs/Stripe/Iz55PVZ_p6hiz6.png)
Clicking this button allows you to capture the payment for an order. You can also refund payments if an order has captured payments.
+1 -1
View File
@@ -120,7 +120,7 @@ If youre on a Twilio trial make sure that the phone number you entered on che
:::
![Twilio Dashboard](https://i.imgur.com/MXtQMiL.png)
![Twilio Dashboard](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001219/Medusa%20Docs/Stripe/MXtQMiL_kb7kxe.png)
## Whats Next
+1 -1
View File
@@ -57,7 +57,7 @@ npm run start
By default, the admin runs on port 7000. So, in your browser, go to `localhost:7000` to view your admin.
![Admin Log In](https://i.imgur.com/XYqMCo9.png)
![Admin Log In](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001604/Medusa%20Docs/Screenshots/XYqMCo9_hq1fsv.png)
Use your Medusa admins user credentials to log in.
@@ -54,7 +54,7 @@ If the batch job fails at any point in this flow, its status is changed to `fail
:::
![Flowchart summarizing the batch job's flow from creation to completion](https://i.imgur.com/Qja0kAz.png)
![Flowchart summarizing the batch job's flow from creation to completion](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001632/Medusa%20Docs/Diagrams/Qja0kAz_ns4vm8.png)
## Whats Next
@@ -267,11 +267,11 @@ You must be authenticated as an admin user before sending this request. You can
:::
![List Notifications Request](https://i.imgur.com/iF1rZX1.png)
![List Notifications Request](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001650/Medusa%20Docs/Screenshots/iF1rZX1_msps2t.png)
Then, send a request to the [Resend Notification](https://docs.medusajs.com/api/admin/#tag/Notification/operation/PostNotificationsNotificationResend) endpoint using the ID retrieved from the previous request. You can pass the `to` parameter in the body to change the receiver of the notification. You should see the message “Notification Resent” in your console and if you implemented your own logic for resending the notification it will be resent.
![Resend Notifications Request](https://i.imgur.com/0zFfPed.png)
![Resend Notifications Request](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001659/Medusa%20Docs/Screenshots/0zFfPed_og7one.png)
This request returns the same notification object as the List Notifications endpoint, but it now has a new object in the `resends` array. This is the resent notification. If you supplied a `to` parameter in the request body, you should see its value in the `to` property of the resent notification object.
@@ -40,7 +40,7 @@ All these methods must be declared async in the Payment Provider Service.
These methods are used at different points in the Checkout flow as well as when processing the order after its placed.
![Payment Flows.jpg](https://i.imgur.com/WeDr0ph.jpg)
![Checkout Flow - Payment](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001750/Medusa%20Docs/Diagrams/WeDr0ph_idcrir.jpg)
## Create a Payment Provider
@@ -17,7 +17,7 @@ Its also constructed to support multiple regions, provide different shipment
- **Shipping Options:** created by the admin and belong to a shipping profile. They are specific to certain regions and can have cart conditions. They use an underlying fulfillment provider. Once a customer checks out, they can choose the shipping option thats available and most relevant to them.
- **Shipping Method:** created when the customer chooses a shipping option on checkout. The shipping method is basically a copy of the shipping option, but with values specific to the customer and the cart its associated with. When the order is placed, the shipping method will then be associated with the order and fulfilled based on the integration with the fulfillment provider.
![Shipping Architecture](https://i.imgur.com/QII2Hvn.png)
![Shipping Architecture](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001762/Medusa%20Docs/Diagrams/QII2Hvn_vjkrdy.png)
## Fulfillment Provider
@@ -41,11 +41,11 @@ Before you can deploy your Medusa Admin you need to create a GitHub repository a
On GitHub, click the plus icon at the top right, then click New Repository.
![Create Repository](https://i.imgur.com/0YlxBRi.png)
![Create Repository](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001782/Medusa%20Docs/Netlify/0YlxBRi_aiywpo.png)
Youll then be redirected to a new page with a form. In the form, enter the Repository Name then scroll down and click Create repository.
![Repository Form](https://i.imgur.com/YPYXAF2.png)
![Repository Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001800/Medusa%20Docs/Netlify/YPYXAF2_lypjne.png)
### Push Code to GitHub Repository
@@ -53,7 +53,7 @@ The next step is to push the code to the GitHub repository you just created.
After creating the repository, youll be redirected to the repositorys page. On that page, you should see a URL that you can copy to connect your repository to a local directory.
![GitHub Repository URL](https://i.imgur.com/pHfSTuT.png)
![GitHub Repository URL](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001818/Medusa%20Docs/Netlify/pHfSTuT_w544lr.png)
Copy the link. Then, open your terminal in the directory that holds your Medusa Admin codebase and run the following commands:
@@ -88,21 +88,21 @@ Alternatively, if you dont have any other websites, youll see a big button
:::
![Create a new website](https://i.imgur.com/IUUOzoW.png)
![Create a new website](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001840/Medusa%20Docs/Netlify/IUUOzoW_mw9u5w.png)
Youll then be asked to connect to a Git provider.
![Connect Git Provider](https://i.imgur.com/T6lZPDi.png)
![Connect Git Provider](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001855/Medusa%20Docs/Netlify/T6lZPDi_rvcuyf.png)
Choose GitHub. Youll then be redirected to GitHubs website to give Netlify permissions if you havent done that before.
After you authorize Netlify to use GitHub, youll be asked to pick the repository you want to deploy. Pick the repository you just created.
![Choose Repository](https://i.imgur.com/D0r6Q1e.png)
![Choose Repository](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001871/Medusa%20Docs/Netlify/D0r6Q1e_th5uei.png)
In the form that shows, keep all fields the same and click on the “Show advanced” button before the “Deploy site” button.
![Show advanced Button](https://i.imgur.com/nUdwRbq.png)
![Show advanced Button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001884/Medusa%20Docs/Netlify/nUdwRbq_d2kmo6.png)
Under the “Advanced build settings” section click on the “New variable” button. This will show two inputs for the key and value of the environment variable.
@@ -114,23 +114,23 @@ If you havent deployed your Medusa server yet, you can leave the value blank
:::
![Environment Variable](https://i.imgur.com/DnutZfT.png)
![Environment Variable](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001898/Medusa%20Docs/Netlify/DnutZfT_rv8iel.png)
Once youre done, scroll down and click on Deploy site.
Youll be then redirected to the dashboard of the new website. Netlify will build your website in the background. You should see “Site deploy in progress” on the top card.
![Site Deployment Progress](https://i.imgur.com/BCnLPw7.png)
![Site Deployment Progress](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001914/Medusa%20Docs/Netlify/BCnLPw7_uo9odf.png)
The deployment can take a few minutes.
Once the deployment is done, youll find the URL in the place of the “Site deploy in progress” message you saw earlier.
![Deployment Complete](https://i.imgur.com/fNBxCG2.png)
![Deployment Complete](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001929/Medusa%20Docs/Netlify/fNBxCG2_jlq0q9.png)
If you click on it, youll be redirected to the deployed admin website.
![Medusa Admin Login](https://i.imgur.com/6t4ODe4.png)
![Medusa Admin Login](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001604/Medusa%20Docs/Screenshots/XYqMCo9_hq1fsv.png)
:::note
@@ -160,11 +160,11 @@ netlify login
This opens a page to log in on your browser. Youll be asked to authorize the Netlify CLI tool.
![Authorize Application](https://i.imgur.com/JDUdqSE.png)
![Authorize Application](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001985/Medusa%20Docs/Netlify/JDUdqSE_dzveww.png)
Click on Authorize. Then, you can go back to your terminal and see that youve successfully logged in.
![Authorized Message](https://i.imgur.com/L13Yqhp.png)
![Authorized Message](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001998/Medusa%20Docs/Netlify/L13Yqhp_e2ejpx.png)
#### Initialize Netlify Website
@@ -251,7 +251,7 @@ netlify open:site
The Medusa Admin will then open in your browser.
![Medusa Admin Login](https://i.imgur.com/6t4ODe4.png)
![Medusa Admin Login](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001604/Medusa%20Docs/Screenshots/XYqMCo9_hq1fsv.png)
Before you can use Medusa Admin, you must add the URL as an environment variable on your deployed Medusa server.
@@ -74,11 +74,11 @@ Before you can deploy your Medusa server you need to create a GitHub repository
On GitHub, click the plus icon at the top right, then click New Repository.
![Click plus then choose new repository from dropdown](https://i.imgur.com/0YlxBRi.png)
![Click plus then choose new repository from dropdown](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001782/Medusa%20Docs/Netlify/0YlxBRi_aiywpo.png)
Youll then be redirected to a new page with a form. In the form, enter the Repository Name then scroll down and click Create repository.
![New repository form](https://i.imgur.com/YPYXAF2.png)
![New repository form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001800/Medusa%20Docs/Netlify/YPYXAF2_lypjne.png)
### Push Code to GitHub Repository
@@ -86,7 +86,7 @@ The next step is to push the code to the GitHub repository you just created.
After creating the repository, youll be redirected to the repositorys page. On that page, you should see a URL that you can copy to connect your repository to a local directory.
![GitHub repository's URL](https://i.imgur.com/pHfSTuT.png)
![GitHub repository's URL](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001818/Medusa%20Docs/Netlify/pHfSTuT_w544lr.png)
Copy the link. Then, open your terminal in the directory that holds your Medusa server codebase and run the following commands:
@@ -111,13 +111,13 @@ After pushing the changes, you can find the files in your GitHub repository.
After logging into your account, click on the Create button at the top right, then choose App.
![Click Create button then choose Apps](https://i.imgur.com/PQgPZ0q.png)
![Click Create button then choose Apps](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002030/Medusa%20Docs/Digital%20Ocean/PQgPZ0q_xntr2i.png)
### Choose Repository
In the Create App page, choose GitHub from the Service Provider list.
![Choose GitHub from list of providers](https://i.imgur.com/nBY9wGE.png)
![Choose GitHub from list of providers](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002043/Medusa%20Docs/Digital%20Ocean/nBY9wGE_zyy1e6.png)
If you havent given DigitalOcean access before, click on Manage Access under Source Code. Youll then be redirected to GitHub to give DigitalOcean access.
@@ -125,7 +125,7 @@ Once DigitalOcean have access to your GitHub account, you should see a Repositor
Additional inputs will show up to choose the Branch, Source Directory, and Autodeploy options.
![Enter master for Branch input, backslash for Source Directory, and check Autodeploy](https://i.imgur.com/kjk9E2B.png)
![Enter master for Branch input, backslash for Source Directory, and check Autodeploy](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002055/Medusa%20Docs/Digital%20Ocean/kjk9E2B_qpwrx4.png)
If you host your Medusa server in a monorepo, you should change the Source Directory to the directory the server is available in the repository. Otherwise, it can be left as is.
@@ -135,7 +135,7 @@ Once youre done, click Next to move on to the next step.
In the next step, youll see the resources to create.
![List of resources showing a docker resource and web service resource](https://i.imgur.com/6TlpWB9.png)
![List of resources showing a docker resource and web service resource](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002067/Medusa%20Docs/Digital%20Ocean/6TlpWB9_wfppc7.png)
If you have a Dockerfile available in the servers codebase (which is available by default), youll have two resources showing. You can remove it by clicking on the trash icon at the right of the resource.
@@ -143,7 +143,7 @@ By default, DigitalOcean hosts the web service in a sub-path of the domain name
Then, scroll to HTTP Request Routes and expand it by clicking on Edit at its right. Change the value of the Routes input to `/`.
![Enter backslash for Routes](https://i.imgur.com/ta0jHh4.png)
![Enter backslash for Routes](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002076/Medusa%20Docs/Digital%20Ocean/ta0jHh4_ddcz3r.png)
Once youre done click Save. Youll be taken back to the Resources page.
@@ -151,15 +151,15 @@ Once youre done click Save. Youll be taken back to the Resources page.
On the same page, expand the Add Resources section, choose Database, then click Add.
![Choose Database](https://i.imgur.com/MfK9E8o.png)
![Choose Database](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002090/Medusa%20Docs/Digital%20Ocean/MfK9E8o_ensfu0.png)
In the new page, youll be shown a PostgreSQL database to be created. Notice that its important to choose a name that youll remember as youll need the name in next steps. You can leave the name as is if its not necessary to change it.
![Enter db for Choose Name input](https://i.imgur.com/jYxENhr.png)
![Enter db for Choose Name input](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002099/Medusa%20Docs/Digital%20Ocean/jYxENhr_wxkspz.png)
Once youre done, click Create and Attach. Youll be redirected back to the previous page with the database added to the resources.
![Database showing in the list of resources with web service](https://i.imgur.com/jNZ7rxg.png)
![Database showing in the list of resources with web service](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002109/Medusa%20Docs/Digital%20Ocean/jNZ7rxg_msmgbz.png)
Once youre done, click Next to move on to the next step.
@@ -169,7 +169,7 @@ In this section, youll add environment variables that are essential to your M
You should see two ways to add environment variables: Global or specific to the Web Service.
![Global environment variables and web service environment variables](https://i.imgur.com/VOYykPT.png)
![Global environment variables and web service environment variables](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002118/Medusa%20Docs/Digital%20Ocean/VOYykPT_qoili6.png)
Click Edit on the second row to add environment variables specific to the Web Service. Add the following environment variables:
@@ -202,7 +202,7 @@ Once youre done click Save.
In the next section, youll be shown the app info and the region it will be deployed to. You can leave it all as is or make changes if you find it necessary.
![App info and region details](https://i.imgur.com/XVS0yej.png)
![App info and region details](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002128/Medusa%20Docs/Digital%20Ocean/XVS0yej_kwmaim.png)
Once youre done, click Next to go to the next step.
@@ -214,15 +214,15 @@ While the server is being deployed, you can create the Redis resource.
Click the Create button at the top right and choose Database from the dropdown.
![Click Create then choose Databases](https://i.imgur.com/8BzUzuO.png)
![Click Create then choose Databases](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002138/Medusa%20Docs/Digital%20Ocean/8BzUzuO_bhwcpd.png)
In the new page under Choose a database engine, choose Redis.
![For the Choose a database engine input choose Redis](https://i.imgur.com/lninWzJ.png)
![For the Choose a database engine input choose Redis](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002149/Medusa%20Docs/Digital%20Ocean/lninWzJ_joycrd.png)
Then, scroll down to the “Choose a name” input. Since you used the name `redis` in the `REDIS_URL` environment variables, change the value to `redis` here.
![For the choose a name input set the value to redis](https://i.imgur.com/E81Qc4l.png)
![For the choose a name input set the value to redis](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002158/Medusa%20Docs/Digital%20Ocean/E81Qc4l_gid9qa.png)
Once youre done, click on Create Database Cluster.
@@ -232,11 +232,11 @@ Once the Redis database is created go back to the App you created earlier by cho
Click at the white Create button at the top right and choose Create/Attach Database.
![Click at the create button and choose create/attach database](https://i.imgur.com/jdh702G.png)
![Click at the create button and choose create/attach database](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002168/Medusa%20Docs/Digital%20Ocean/jdh702G_fjssat.png)
In the new page, click on the Previously Created DigitalOcean Database radio button. Then, under Database Cluster select the Redis database you just created.
![Choose Previously Created DigitalOcean Database then under Database Cluster choose redis](https://i.imgur.com/aBJ2z0B.png)
![Choose Previously Created DigitalOcean Database then under Database Cluster choose redis](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002177/Medusa%20Docs/Digital%20Ocean/aBJ2z0B_yzwpym.png)
Once youre done click Attach Database. This will add the Redis database to the list of resources of your App and will trigger a redeploy of the App.
@@ -244,11 +244,11 @@ Once youre done click Attach Database. This will add the Redis database to th
Once the redeployment is complete, copy the URL of the App which can be found under the Apps name.
![Copy URL under the app name](https://i.imgur.com/i3ws777.png)
![Copy URL under the app name](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002186/Medusa%20Docs/Digital%20Ocean/i3ws777_ooknst.png)
Then, go to `<YOUR_APP_URL>/store/products`. If the deployment was successful, you should receive a JSON response.
![JSON response with list of products](https://i.imgur.com/5xTdMbY.png)
![JSON response with list of products](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002196/Medusa%20Docs/Digital%20Ocean/5xTdMbY_pqwyzy.png)
## Run Commands on Your Server
@@ -263,7 +263,7 @@ medusa user --email <EMAIL> --password <PASSWORD>
Make sure to replace `<EMAIL>` and `<PASSWORD>` with the credentials you want to give the user.
![Console in the DigitalOcean App](https://i.imgur.com/9RMfD4C.png)
![Console in the DigitalOcean App](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002204/Medusa%20Docs/Digital%20Ocean/9RMfD4C_u0mdqs.png)
## Add Environment Variables
@@ -271,11 +271,11 @@ Youll likely need to add environment variables later such as Admin Cross-Orig
To add environment variables, on the Apps page click on Settings and choose the Web Service component.
![Choose the Settings tab then choose the web service container](https://i.imgur.com/qLPARaV.png)
![Choose the Settings tab then choose the web service container](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002217/Medusa%20Docs/Digital%20Ocean/qLPARaV_ocit6w.png)
Then, scroll down and find Environment Variables. You can expand the environment variables by clicking Edit on the right. Here, you can edit, add, and remove environment variables.
![Expand the Environment Variables section by clicking edit](https://i.imgur.com/4x6JGjX.png)
![Expand the Environment Variables section by clicking edit](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002227/Medusa%20Docs/Digital%20Ocean/4x6JGjX_wzltiq.png)
Once you click Save, the environment variables will be saved and a redeployment will be triggered.
@@ -48,11 +48,11 @@ Before you can deploy your Medusa server you need to create a GitHub repository
On GitHub, click the plus icon at the top right, then click New Repository.
![Click plus icon at the top right](https://i.imgur.com/0YlxBRi.png)
![Click plus icon at the top right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001782/Medusa%20Docs/Netlify/0YlxBRi_aiywpo.png)
Youll then be redirected to a new page with a form. In the form, enter the Repository Name then scroll down and click Create repository.
![An image of the Create Repository form](https://i.imgur.com/YPYXAF2.png)
![An image of the Create Repository form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001800/Medusa%20Docs/Netlify/YPYXAF2_lypjne.png)
### Push Code to GitHub Repository
@@ -60,7 +60,7 @@ The next step is to push the code to the GitHub repository you just created.
After creating the repository, youll be redirected to the repositorys page. On that page, you should see a URL that you can copy to connect your repository to a local directory.
![An image of the GitHub URL in a new repository](https://i.imgur.com/pHfSTuT.png)
![An image of the GitHub URL in a new repository](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001818/Medusa%20Docs/Netlify/pHfSTuT_w544lr.png)
Copy the link. Then, open your terminal in the directory that holds your Medusa server codebase and run the following commands:
@@ -477,7 +477,7 @@ If you run into any errors while running this command, you can just re-run it af
Once the command finishes and the deployment is successful, you can access your server in the [Qovery Console](https://console.qovery.com/). Go to the project, environment, then the app that you created using Terraform and Qovery. In the app, click the Open button at the top right to open your website in a new tab.
![open button at the top right](https://i.imgur.com/Ji59ZSJ.png)
![open button at the top right](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002245/Medusa%20Docs/Qovery/Ji59ZSJ_nrkpvb.png)
You can access any of the endpoints on your server using the server URL. For example, you can get the list of products using the endpoint `/store/products`.
@@ -504,7 +504,7 @@ Youll likely need to add environment variables later such as Admin Cross-Orig
To add environment variables, in your [Qovery Console](https://console.qovery.com/) go to the Medusa app and choose Environment Variables from the sidebar. You can add environment variables here at any point later on.
![Environment Variables in the sidebar](https://i.imgur.com/aQl7zdz.png)
![Environment Variables in the sidebar](https://res.cloudinary.com/dza7lstvk/image/upload/v1668002258/Medusa%20Docs/Qovery/aQl7zdz_tjs0eb.png)
## Whats Next
@@ -41,11 +41,11 @@ Before you can deploy your Gatsby storefront you need to create a GitHub reposit
On GitHub, click the plus icon at the top right, then click New Repository.
![Create Repository](https://i.imgur.com/0YlxBRi.png)
![Create Repository](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001782/Medusa%20Docs/Netlify/0YlxBRi_aiywpo.png)
Youll then be redirected to a new page with a form. In the form, enter the Repository Name then scroll down and click Create repository.
![Repository Form](https://i.imgur.com/YPYXAF2.png)
![Repository Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001800/Medusa%20Docs/Netlify/YPYXAF2_lypjne.png)
### Push Code to GitHub Repository
@@ -53,7 +53,7 @@ The next step is to push the code to the GitHub repository you just created.
After creating the repository, youll be redirected to the repositorys page. On that page, you should see a URL that you can copy to connect your repository to a local directory.
![GitHub Repository URL](https://i.imgur.com/pHfSTuT.png)
![GitHub Repository URL](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001818/Medusa%20Docs/Netlify/pHfSTuT_w544lr.png)
Copy the link. Then, open your terminal in the directory that holds your Gatsby storefront codebase and run the following commands:
@@ -88,21 +88,21 @@ Alternatively, if you dont have any other websites, youll see a big button
:::
![Create a new website](https://i.imgur.com/IUUOzoW.png)
![Create a new website](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001840/Medusa%20Docs/Netlify/IUUOzoW_mw9u5w.png)
Youll then be asked to connect to a Git provider.
![Connect Git Provider](https://i.imgur.com/T6lZPDi.png)
![Connect Git Provider](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001855/Medusa%20Docs/Netlify/T6lZPDi_rvcuyf.png)
Choose GitHub. Youll then be redirected to GitHubs website to give Netlify permissions if you havent done that before.
After you authorize Netlify to use GitHub, youll be asked to pick the repository you want to deploy. Pick the repository you just created.
![Choose Repository](https://i.imgur.com/SRI3r1Y.png)
![Choose Repository](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003038/Medusa%20Docs/Netlify/SRI3r1Y_hqwy8r.png)
In the form that shows, keep all fields the same and click on the “Show advanced” button before the “Deploy site” button.
![Show advanced Button](https://i.imgur.com/nUdwRbq.png)
![Show advanced Button](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001884/Medusa%20Docs/Netlify/nUdwRbq_d2kmo6.png)
Under the “Advanced build settings” section click on the “New variable” button. This will show two inputs for the key and value of the environment variable.
@@ -114,7 +114,7 @@ If you havent deployed your Medusa server yet, you can leave the value blank
:::
![Environment Variable](https://i.imgur.com/DnutZfT.png)
![Environment Variable](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001898/Medusa%20Docs/Netlify/DnutZfT_rv8iel.png)
:::note
@@ -126,7 +126,7 @@ Once youre done, scroll down and click on Deploy site.
Youll be then redirected to the dashboard of the new website. Netlify will build your website in the background. You should see “Site deploy in progress” on the top card.
![Site Deployment Progress](https://i.imgur.com/PUDjjnL.png)
![Site Deployment Progress](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003051/Medusa%20Docs/Netlify/PUDjjnL_hwuywi.png)
The deployment can take a few minutes.
@@ -144,11 +144,11 @@ medusa seed -f data/seed.json
:::
![Deployment Complete](https://i.imgur.com/dPF9HvF.png)
![Deployment Complete](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003068/Medusa%20Docs/Netlify/dPF9HvF_ibnoo1.png)
If you click on it, youll be redirected to the deployed storefront website.
![Gatsby Storefront](https://i.imgur.com/l08cBSA.png)
![Gatsby Storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003076/Medusa%20Docs/Netlify/l08cBSA_eanbne.png)
:::caution
@@ -178,11 +178,11 @@ netlify login
This opens a page to log in on your browser. Youll be asked to authorize the Netlify CLI tool.
![Authorize Application](https://i.imgur.com/JDUdqSE.png)
![Authorize Application](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001985/Medusa%20Docs/Netlify/JDUdqSE_dzveww.png)
Click on Authorize. Then, you can go back to your terminal and see that youve successfully logged in.
![Authorized Message](https://i.imgur.com/L13Yqhp.png)
![Authorized Message](https://res.cloudinary.com/dza7lstvk/image/upload/v1668001998/Medusa%20Docs/Netlify/L13Yqhp_e2ejpx.png)
#### Initialize Netlify Website
@@ -287,7 +287,7 @@ netlify open:site
The Gatsby storefront will then open in your browser.
![Gatsby Storefront](https://i.imgur.com/l08cBSA.png)
![Gatsby Storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003089/Medusa%20Docs/Netlify/l08cBSA_yfj2rz.png)
Before you can use the Gatsby storefront, you must add the URL as an environment variable on your deployed Medusa server.
+1 -1
View File
@@ -6,7 +6,7 @@ title: Architecture Overview
Medusa is composed of three components: The headless backend, the admin dashboard, and the storefront.
![Medusa's Architecture](https://i.imgur.com/ZHvM2bu.png)
![Medusa's Architecture](https://res.cloudinary.com/dza7lstvk/image/upload/v1667999772/Medusa%20Docs/Diagrams/ZHvM2bu_td4rnx.png)
## Headless Backend
@@ -2,7 +2,7 @@
This document guides you to install and set up the Gatsby Storefront for your Medusa Server.
![Gatsby Storefront Quick Look](https://i.imgur.com/LcAsi8r.gif)
![Gatsby Storefront Quick Look](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003111/Medusa%20Docs/Screenshots/LcAsi8r_yivcro.gif)
## Instant Deployment to Netlify
@@ -98,16 +98,16 @@ The Gatsby storefront comes with a lot of features out of the box including:
- View all products and manage your cart.
![Products Page](https://i.imgur.com/P0Mpvxh.png)
![Products Page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003126/Medusa%20Docs/Screenshots/P0Mpvxh_qznct6.png)
- Customer authentication.
![Sign In Page](https://i.imgur.com/0sVcZeS.png)
![Sign In Page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003139/Medusa%20Docs/Screenshots/0sVcZeS_z6cftp.png)
- Full checkout workflow.
![One-Page Checkout](https://i.imgur.com/5wSs3yZ.png)
![One-Page Checkout](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003152/Medusa%20Docs/Screenshots/5wSs3yZ_iivxrh.png)
- Request swaps and returns using a customers order ID and Email.
![Request Return for Order](https://i.imgur.com/mAChp3f.png)
![Request Return for Order](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003162/Medusa%20Docs/Screenshots/mAChp3f_ubd89n.png)
## Whats Next
@@ -2,7 +2,7 @@
This document guides you to install and set up the Next.js Storefront for your Medusa Server.
![Next.js Storefront Demo](https://i.imgur.com/koJl8uR.gif)
![Next.js Storefront Demo](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003177/Medusa%20Docs/Screenshots/koJl8uR_n3gvii.gif)
## Instant Deployment to Netlify
@@ -98,7 +98,7 @@ To make sure the Next.js storefront properly displays the products in the search
:::
![Search Result on Next.js storefront](https://i.imgur.com/gQVWvH2.png)
![Search Result on Next.js storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003191/Medusa%20Docs/Screenshots/gQVWvH2_h1ljig.png)
### Algolia Integration
@@ -133,7 +133,7 @@ export const SEARCH_INDEX_NAME =
Then, restart the Next.js server. Youll be able to search through available products by clicking the search icon in the navigation bar.
![Search Pop-up in Next.js Storefront](https://i.imgur.com/ZLgX5Ad.png)
![Search Pop-up in Next.js Storefront](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003205/Medusa%20Docs/Screenshots/ZLgX5Ad_po6a4n.png)
### Stripe Payment Integration
@@ -149,7 +149,7 @@ Make sure to replace `<YOUR_PUBLISHABLE_KEY>` with your Stripe publishable key.
If you restart your Next.js server you should be able to pay with Stripe on checkout.
![Pay with Stripe on Checkout](https://i.imgur.com/h5mWdJT.png)
![Pay with Stripe on Checkout](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003250/Medusa%20Docs/Screenshots/h5mWdJT_yjogcq.png)
### PayPal Payment Integration
@@ -165,7 +165,7 @@ Make sure to replace `<YOUR_CLIENT_ID>` with your PayPal client ID. You can retr
If you restart your Next.js server you should be able to pay with PayPal on checkout.
![Pay with PayPal on Checkout](https://i.imgur.com/F8OvsOJ.png)
![Pay with PayPal on Checkout](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003264/Medusa%20Docs/Screenshots/F8OvsOJ_mlx0le.png)
### Customization
@@ -204,15 +204,15 @@ You can learn more about development with Next.js through [their documentation](
- View all products and manage your cart.
![All Products Page](https://i.imgur.com/1vLAYbH.png)
![All Products Page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003278/Medusa%20Docs/Screenshots/1vLAYbH_sulxrr.png)
- Customer authentication and profiles.
![Customer Profile](https://i.imgur.com/etW3b3L.png)
![Customer Profile](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003287/Medusa%20Docs/Screenshots/etW3b3L_wccrez.png)
- Full checkout workflow.
![Checkout Page](https://i.imgur.com/VC8SYfb.png)
![Checkout Page](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003296/Medusa%20Docs/Screenshots/VC8SYfb_eowjno.png)
## Whats Next
+1 -1
View File
@@ -4,7 +4,7 @@ If you are experiencing connection issues when trying to access your Medusa serv
You might see a log in your browser console, that looks like this:
![CORS error log](https://i.imgur.com/jnHK115.png)
![CORS error log](https://res.cloudinary.com/dza7lstvk/image/upload/v1668003322/Medusa%20Docs/Other/jnHK115_udgf2n.png)
In your `medusa-config.js` , you should ensure that you've configured your CORS settings correctly. By default, the Medusa starter runs on port `9000`, Medusa Admin runs on port `7000`, and the storefront starters run on port `8000`.
@@ -25,9 +25,7 @@ npm install medusa-payment-stripe
However, to also show them as part of your checkout flow you need to add them to your regions.
In the Medusa Admin go to Settings > Regions and for each region scroll down to the Payment Provider input and choose the payment provider you want to use in that region:
![Enable Payment Provider](https://i.imgur.com/FH5vgWh.png)
In the Medusa Admin go to Settings > Regions and for each region scroll down to the Payment Provider input and choose the payment provider you want to use in that region.
## Additional Resources
+5 -5
View File
@@ -20,7 +20,7 @@ To create a customer group:
2. Optionally, to add metadata:
1. Click on the Add Metadata button.
2. Enter a value for the Key and Value Fields.
3. To remove a metadata field, click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
3. To remove a metadata field, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
5. Once youre done, click on the Publish Group button.
---
@@ -40,14 +40,14 @@ To view the details of a customer group:
To edit a customer group:
1. Go to the customer groups details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the right of the groups name.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the right of the groups name.
3. Click on Edit in the dropdown.
4. In the new window that opens:
1. You can change the title and existing metadata of the group.
2. To add metadata:
1. Click on the Add Metadata button.
2. Enter a value for the Key and Value Fields.
3. To remove metadata click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
3. To remove metadata click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
5. Once youre done, click on the Edit Group button.
---
@@ -81,7 +81,7 @@ Removing customers from a customer group doesn't remove the customers from your
To remove customers from a customer group:
1. Go to the customer groups details page.
2. In the Customer section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the customer you want to remove from the group.
2. In the Customer section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the customer you want to remove from the group.
3. Click on “Delete from the Group” from the dropdown.
### Remove Multiple Customers from a Group
@@ -112,6 +112,6 @@ Deleting a customer group cannot be undone.
To delete a customer group:
1. Go to the customer groups details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the right of the groups name.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the right of the groups name.
3. Click on Delete from the dropdown.
4. Confirm deleting the price list by clicking the “Yes, delete” button in the pop-up.
+1 -1
View File
@@ -22,7 +22,7 @@ To view a customers details:
To edit a customers details:
1. Go to a Customers details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the first section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the first section.
3. Choose Edit from the dropdown.
4. In the new window that opens, you can edit the customers details.
5. Once youre done, click on the Save button.
+12 -12
View File
@@ -26,7 +26,7 @@ To create a Gift Card:
- You can optionally enter a description and a thumbnail.
- Click on Add Denomination. You must at least add one denomination
- For each denomination, choose the currency and amount.
- If you want to delete a denomination, you can click the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
- If you want to delete a denomination, you can click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
3. Once youre done, click Create & Publish.
:::tip
@@ -42,7 +42,7 @@ If you want to add more than one currency value for a denomination, you can do t
To edit a Gift Card:
1. Go to the Gift Cards page from the sidebar menu.
2. Next to the main gift card, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. Next to the main gift card, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Choose Edit from the dropdown.
This opens a form to edit the gift card details and denominations.
@@ -72,7 +72,7 @@ In the window that opens:
3. Optionally, you can enter other values for the denominations. This is useful if you want to enter an amount in another currency. To do that:
- Click on “Add a price” under Other Values.
- Choose the currency and amount.
- To delete a price under Other Values, click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
- To delete a price under Other Values, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
4. Once youre done, click Save.
### Edit a Denomination
@@ -80,12 +80,12 @@ In the window that opens:
To edit a denomination:
1. In the Denominations section, find the denomination you want to edit.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the same row as the denomination you want to edit.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the same row as the denomination you want to edit.
3. Click on Edit Denomination from the dropdown.
4. This opens a new window to edit the denomination. You can then:
- Edit the currency or amount of existing prices of the denomination.
- Add prices for other currencies by clicking “Add a price”
- Delete prices by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
- Delete prices by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
5. Once youre done, click Save.
### Delete a Denomination
@@ -99,7 +99,7 @@ If you delete a denomination, customers wont be able to find it in the storef
To delete a denomination:
1. In the Denominations section, find the denomination you want to edit.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the same row as the denomination you want to delete.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the same row as the denomination you want to delete.
3. Click on Delete Denomination from the dropdown.
4. Confirm deleting the denomination by clicking the “Yes, delete” button in the pop-up.
@@ -148,7 +148,7 @@ If you delete an image, you wont be able to restore it.
To delete a gift card image:
1. Go to the Images section.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon at the right of the image you want to delete.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon at the right of the image you want to delete.
3. Click Save at the bottom right of the page.
---
@@ -163,12 +163,12 @@ Unpublishing a gift card prevents customers from seeing the gift card in the sto
### On Gift Cards Page
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the main gift card.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the main gift card.
2. Choose Unpublish.
### On Edit Gift Card Page
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the Product Information section.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the Product Information section.
2. Choose Unpublish Gift Card from the dropdown.
---
@@ -183,12 +183,12 @@ Publishing a gift card allows customers to see the gift card on the storefront,
### On Gift Cards Page
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the main gift card.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the main gift card.
2. Choose Publish.
### On Edit Gift Card Page
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the Product Information section.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the Product Information section.
2. Choose Publish Gift Card from the dropdown.
---
@@ -204,6 +204,6 @@ If you delete a gift card, you cant restore it or its settings. Customers als
To delete a gift card:
1. Go to the Gift Cards page from the sidebar menu.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the main gift card.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the main gift card.
3. Choose Delete from the dropdown.
4. Confirm deleting the gift card by clicking the “Yes, delete” button in the pop-up.
+9 -9
View File
@@ -15,7 +15,7 @@ If you dont have a Medusa admin yet, you can check [the live demo](https://de
:::
![Medusa Admin Overview](https://i.imgur.com/RdrJznk.png)
![Medusa Admin Overview](https://res.cloudinary.com/dza7lstvk/image/upload/v1667923680/Medusa%20Docs/User%20Guide/RdrJznk_ejddsm.png)
## Accessing the Medusa Admin
@@ -23,7 +23,7 @@ To access the admin panel of your ecommerce store, you must have a URL to the de
Once you open the URL, youll be asked to log in.
![Log In Page](https://i.imgur.com/cUYLszZ.png)
![Log In Page](https://res.cloudinary.com/dza7lstvk/image/upload/v1667923937/Medusa%20Docs/User%20Guide/cUYLszZ_bksyzs.png)
You must use your users email and password to log in. If youre unsure what your email and password are, please contact the technical personnel that deployed your Medusa server and admin.
@@ -37,7 +37,7 @@ The sidebar menu includes the main navigation of your Medusa admin. You can use
You can also see your team members in the sidebar menu. These are the users that can access the Medusa Admin.
![Sidebar Menu](https://i.imgur.com/KZlWoUi.png)
![Sidebar Menu](https://res.cloudinary.com/dza7lstvk/image/upload/v1667923971/Medusa%20Docs/User%20Guide/KZlWoUi_pf5a2f.png)
### Search Bar
@@ -53,24 +53,24 @@ Mac OS: <kbd>⌘</kbd> + <kbd>K</kbd>
:::
![Search Window](https://i.imgur.com/z9a1NLK.png)
![Search Window](https://res.cloudinary.com/dza7lstvk/image/upload/v1667923987/Medusa%20Docs/User%20Guide/z9a1NLK_ojyfn0.png)
You can either select a resolve with your mouse, or use the up and down arrows on your keyboard to navigate between the results, then choosing a result by hitting the Enter key.
### Check Notifications
At the top right youll find a <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon. Clicking this icon opens a side window to view any notifications you might have. You can use this to view notifications such as completed product exports.
At the top right youll find a <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon. Clicking this icon opens a side window to view any notifications you might have. You can use this to view notifications such as completed product exports.
![Notifications Window](https://i.imgur.com/cTIu9yP.png)
![Notifications Window](https://res.cloudinary.com/dza7lstvk/image/upload/v1667924034/Medusa%20Docs/User%20Guide/cTIu9yP_ubsbqx.png)
### Quick Actions
At the top right, youll find an avatar icon. By clicking this icon, youll see a dropdown. You can use this dropdown to quickly access settings or sign out.
![Quick Actions Dropdown](https://i.imgur.com/YgVKTLH.png)
![Quick Actions Dropdown](https://res.cloudinary.com/dza7lstvk/image/upload/v1667924052/Medusa%20Docs/User%20Guide/YgVKTLH_t8zrqw.png)
### Need Help
At the top right, youll find a <UiIcon lightIcon="https://i.imgur.com/CrABja9.png" darkIcon="https://i.imgur.com/cgeX2hP.png" alt="question mark" /> icon. When you click on this icon, a form will pop up. You can use this form to send the Medusa team a message asking for help. The Medusa team usually responds in a few hours on business days.
At the top right, youll find a <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999071/Medusa%20Docs/UI%20Icons/CrABja9_lwomxs.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999095/Medusa%20Docs/UI%20Icons/cgeX2hP_b1vkwy.png" alt="question mark" /> icon. When you click on this icon, a form will pop up. You can use this form to send the Medusa team a message asking for help. The Medusa team usually responds in a few hours on business days.
![Get Help Form](https://i.imgur.com/8Fpa0gr.png)
![Get Help Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1667924070/Medusa%20Docs/User%20Guide/8Fpa0gr_sjovih.png)
+11 -11
View File
@@ -18,7 +18,7 @@ On a table with a list of items, youll find quick filters at the top of the l
You can click on one of these filters to quickly apply it to the list of items.
![https://i.imgur.com/eVwD0JP.png](https://i.imgur.com/eVwD0JP.png)
![Quick filters for lists](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998663/Medusa%20Docs/User%20Guide/eVwD0JP_ukor4r.png)
### Advanced Filters
@@ -26,13 +26,13 @@ You can use advanced filters to furthermore limit the items shown based on speci
To use advanced filters:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon next to Filters. This will toggle a dropdown with categories for different fields.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon next to Filters. This will toggle a dropdown with categories for different fields.
2. You can click on a field name to expand it and choose a filter for that field.
3. Click on the Apply button at the top of the dropdown.
This will retrieve the items based on the filters youve selected.
![https://i.imgur.com/rg9nKcS.png](https://i.imgur.com/rg9nKcS.png)
![Advanced filters for lists](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998724/Medusa%20Docs/User%20Guide/rg9nKcS_vpwcrg.png)
### Save Advanced Filters as Quick Filters
@@ -40,31 +40,31 @@ If there are filters that you need to use frequently, you can give the set of fi
To save an advanced filter:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon next to Filters.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon next to Filters.
2. Choose your filters from the dropdown.
3. Choose a name for the filters in the input at the end of the dropdown.
4. Click the Save button.
![https://i.imgur.com/0nKZ5BX.png](https://i.imgur.com/0nKZ5BX.png)
![Saved Quick filters](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998745/Medusa%20Docs/User%20Guide/0nKZ5BX_r5tdld.png)
Once you click Save, you should see the new filter you added next to the Quick Filters at the top of the list.
![https://i.imgur.com/ymuSHkv.png](https://i.imgur.com/ymuSHkv.png)
![Custom Quick filters shown at the top](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998777/Medusa%20Docs/User%20Guide/ymuSHkv_xey8ao.png)
To apply a saved quick filter, just click on it.
### Delete Saved Quick Filters
You can delete any saved filter youve created. To do that, simply click on the <UiIcon lightIcon="https://i.imgur.com/kvGRHQR.png" darkIcon="https://i.imgur.com/RJ4SLIu.png" alt="X" /> icon next to the quick filters name, and it will be deleted.
You can delete any saved filter youve created. To do that, simply click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999180/Medusa%20Docs/UI%20Icons/kvGRHQR_s0ptsm.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999200/Medusa%20Docs/UI%20Icons/RJ4SLIu_n30zqr.png" alt="X" /> icon next to the quick filters name, and it will be deleted.
### Clear Filters
To clear all applied filters:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon next to Filters.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon next to Filters.
2. Click on the Clear button.
![https://i.imgur.com/ArawLDT.png](https://i.imgur.com/ArawLDT.png)
![Clear filters](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998828/Medusa%20Docs/User%20Guide/ArawLDT_mjye2n.png)
:::info
@@ -76,9 +76,9 @@ Clearing filters does not delete saved quick filters. You can still apply them b
## Search Items
You can search for items in a list by clicking the <UiIcon lightIcon="https://i.imgur.com/k0U0wpO.png" darkIcon="https://i.imgur.com/IdKjFak.png" alt="magnifier" /> icon at the top right of the list.
You can search for items in a list by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999227/Medusa%20Docs/UI%20Icons/k0U0wpO_pizpfd.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999249/Medusa%20Docs/UI%20Icons/IdKjFak_ultvmh.png" alt="magnifier" /> icon at the top right of the list.
![https://i.imgur.com/Z09rbmQ.png](https://i.imgur.com/Z09rbmQ.png)
![Search items in a list](https://res.cloudinary.com/dza7lstvk/image/upload/v1667998849/Medusa%20Docs/User%20Guide/Z09rbmQ_jgi4ti.png)
---
+10 -10
View File
@@ -25,7 +25,7 @@ If you create a claim of type Refund, a refund is issued to the customer right a
:::
1. Open the order details page.
2. In the Timeline section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right.
2. In the Timeline section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right.
3. Click on Register Claim in the dropdown.
4. In the new window that opens:
- Choose the items you want to create the claim for. For each item you pick, you must select the reason for the claim:
@@ -35,10 +35,10 @@ If you create a claim of type Refund, a refund is issued to the customer right a
- Click on the Add button.
- Choose the Shipping method to use to return the item.
- You can add a custom price for the shipping method by clicking on the Add custom price button.
- You can remove the custom price by clicking on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon next to the price.
- You can remove the custom price by clicking on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon next to the price.
- Choose whether the type of the claim is “Refund” or “Replace”. If you choose “Replace”:
- Choose the products you want to send to the customer by clicking Add Product and choosing the product you want to add.
- You can remove a product from the “items to send” list by clicking on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
- You can remove a product from the “items to send” list by clicking on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
- If you want to send the items to another address, click on “Ship to a different address” and fill out the shipping address info.
- Choose the Shipping Method that will be used to deliver the replacement items.
- If you dont want the customer to receive an email that a claim has been created, uncheck the “Send notifications” checkbox.
@@ -51,7 +51,7 @@ If you create a claim of type Refund, a refund is issued to the customer right a
To view an orders claim details:
1. Open the order details page.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Click on More Details in the dropdown.
---
@@ -79,7 +79,7 @@ Canceling a return cant be undone.
To cancel a return of a claim:
1. Open the order details page.
2. In the Timeline section, find the return requested and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Timeline section, find the return requested and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on “Cancel return” in the dropdown.
---
@@ -99,10 +99,10 @@ You can create fulfillment for items in the claim that you are sending to the cu
To create a fulfillment for a claim:
1. Open the order details page.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on Fulfill Claim in the dropdown.
4. In the window that opens:
- Choose the items you want to fulfill. You can change the quantity of the items youre fulfilling using the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> and <UiIcon lightIcon="https://i.imgur.com/EGk9uYD.png" darkIcon="https://i.imgur.com/XvkBK8p.png" alt="minus" /> icons.
- Choose the items you want to fulfill. You can change the quantity of the items youre fulfilling using the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> and <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999351/Medusa%20Docs/UI%20Icons/EGk9uYD_a7rwhs.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999366/Medusa%20Docs/UI%20Icons/XvkBK8p_dzhzfx.png" alt="minus" /> icons.
- Optionally add under Metadata any additional information that might be necessary for the fulfillment.
- If you dont want the customer to receive an email that a fulfillment for the claim items has been created, uncheck the “Send notifications” checkbox.
5. Once youre done, click on the Complete button.
@@ -114,7 +114,7 @@ To mark a claims fulfillment as shipped:
1. Open the order details page.
2. Scroll down to the Fulfillment section.
3. Find the fulfillment you want to mark as shipped. A claims fulfillments title should be prefixed with “Claim fulfillment”.
4. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
4. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
5. Click on Mark Shipped in the dropdown.
6. In the new window that opens:
- Enter a tracking number for the shipment.
@@ -137,7 +137,7 @@ To cancel a claims fulfillment:
1. Open the order details page.
2. Scroll down to the Fulfillment section.
3. Find the fulfillment you want to cancel. A claims fulfillments title should be prefixed with “Claim fulfillment”.
4. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
4. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
5. Click on Cancel Fulfillment in the dropdown.
6. Confirm canceling the fulfillment by clicking the “Yes, confirm” button in the pop-up.
@@ -160,6 +160,6 @@ Canceling a claim cant be undone. The [return of the claim must be canceled](
To cancel a claim of type Replace:
1. Open the order details page.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Timeline section, find the claim and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on Cancel Claim in the dropdown.
4. Confirm canceling the fulfillment by clicking the “Yes, remove” button in the pop-up.
+5 -5
View File
@@ -33,12 +33,12 @@ To create a draft order:
1. Click on the Add Custom button.
2. Enter the title, price, and quantity of the custom item.
3. Click on the Add button.
3. To remove an item you added, click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon at the right of the item.
4. To change the quantity of any item, use the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> and <UiIcon lightIcon="https://i.imgur.com/EGk9uYD.png" darkIcon="https://i.imgur.com/XvkBK8p.png" alt="minus" /> icons under the Quantity column.
3. To remove an item you added, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon at the right of the item.
4. To change the quantity of any item, use the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> and <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999351/Medusa%20Docs/UI%20Icons/EGk9uYD_a7rwhs.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999366/Medusa%20Docs/UI%20Icons/XvkBK8p_dzhzfx.png" alt="minus" /> icons under the Quantity column.
5. Once youre done, click the Next button.
3. In the third step, choose a shipping method then click the Next button.
1. If you want to change the default price of the shipping method, click on the “Set custom price” button and enter the price you want to use.
2. If you want to remove the custom price, you can click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
2. If you want to remove the custom price, you can click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
4. In the fourth step, enter the customers details and shipping address.
1. If the customer already exists, you can choose it from the first input. You can search the list of customers by name or email. This fills out the fields under the General section as well.
2. If this is a new customer, in the first field, enter the email of the customer to add. Then, fill out the customers first name, last name, and phone number in the General section.
@@ -71,7 +71,7 @@ To open a draft orders details page:
To edit the shipping address of a draft order:
1. Open the draft order details page.
2. Scroll down to the customer section and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in that section.
2. Scroll down to the customer section and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in that section.
3. Click on Edit Shipping Address in the dropdown.
4. This opens a new window to edit the shipping addresss info.
5. Once youre done click on the Save button.
@@ -89,7 +89,7 @@ Canceling a draft order cannot be undone and the draft order will be removed fro
To cancel a draft order:
1. Open the draft order details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right.
3. Click on Cancel Draft Order in the dropdown.
4. Confirm canceling the draft order by clicking the “Yes, remove” button in the pop-up.
+6 -6
View File
@@ -26,7 +26,7 @@ An exchange can only be created if the orders payment is captured and the ite
To create an order exchange:
1. Go to an orders details page.
2. In the Timeline section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Timeline section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on Register Exchange from the dropdown.
4. In the new window that opens:
1. Choose the items you want the customer to return. For each item you select:
@@ -36,12 +36,12 @@ To create an order exchange:
4. Once youre done, click on the Add button.
2. Choose a Shipping Method to return the customers items.
1. You can optionally specify a custom price for shipping by clicking the “Add custom price” button.
2. You can remove the custom price by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
2. You can remove the custom price by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
3. In the “Items to send” section, click on the Add Product button. Then:
1. Check the products you want to send to the customer in exchange.
2. When youre done, click the Add button.
3. You can remove products youve added by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
4. You can change the quantity of the product to send using the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> and <UiIcon lightIcon="https://i.imgur.com/EGk9uYD.png" darkIcon="https://i.imgur.com/XvkBK8p.png" alt="minus" /> icons.
3. You can remove products youve added by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
4. You can change the quantity of the product to send using the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> and <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999351/Medusa%20Docs/UI%20Icons/EGk9uYD_a7rwhs.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999366/Medusa%20Docs/UI%20Icons/XvkBK8p_dzhzfx.png" alt="minus" /> icons.
4. If you dont want the customer to receive an email that an exchange has been registered, uncheck the “Send notifications” checkbox.
5. Once youre done, click the Complete button.
@@ -69,9 +69,9 @@ To cancel an exchange:
1. Go to an orders details page.
2. In the Timeline section, find the order exchange.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
4. Click on “Cancel return” from the dropdown.
5. Confirm canceling the return by clicking the “Yes, cancel” button in the pop-up.
6. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon again next to the order exchange.
6. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon again next to the order exchange.
7. Click on “Cancel exchange” from the dropdown.
8. Confirm canceling the exchange by clicking the “Yes, cancel” button in the pop-up.
+3 -3
View File
@@ -21,7 +21,7 @@ To export orders:
1. Go to Orders page.
2. Click on Export Orders at the top right.
3. Click Export in the window that opens.
4. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
4. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
5. You should see your new export loading.
6. Once the export is ready, click on the Download button.
@@ -43,7 +43,7 @@ You can only cancel an unfinished order export.
To cancel an order export:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the export you want to cancel.
3. Click on the cancel button.
@@ -59,6 +59,6 @@ You can only delete a finished order export.
To delete an order export:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the export you want to delete.
3. Click on the Delete button.
@@ -33,7 +33,7 @@ To create a fulfillment for an order:
2. Scroll down to the Fulfillment section.
3. Click on the Create Fulfillment button.
4. In the window that opens:
- Choose the items you want to create the fulfillment for. These are the items youll ship together. You can also choose a specific quantity of an item to ship using the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> and <UiIcon lightIcon="https://i.imgur.com/EGk9uYD.png" darkIcon="https://i.imgur.com/XvkBK8p.png" alt="minus" /> icons under the Quantity column.
- Choose the items you want to create the fulfillment for. These are the items youll ship together. You can also choose a specific quantity of an item to ship using the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> and <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999351/Medusa%20Docs/UI%20Icons/EGk9uYD_a7rwhs.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999366/Medusa%20Docs/UI%20Icons/XvkBK8p_dzhzfx.png" alt="minus" /> icons under the Quantity column.
- Optionally enter any additional information you want to associate with the fulfillment under the Metadata section.
- If you dont want the customer to receive an email that a fulfillment has been created, uncheck the “Send notifications” checkbox.
5. Once done, click on the Complete button.
@@ -54,7 +54,7 @@ To mark a fulfillment as shipped in an order:
1. Open the order details page.
2. Scroll down to the Fulfillment section.
3. Find the fulfillment you want to mark as shipped, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
3. Find the fulfillment you want to mark as shipped, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
4. Click on Mark Shipped in the dropdown.
5. In the new window that opens:
- Enter a tracking number for the shipment.
@@ -78,6 +78,6 @@ To cancel a fulfillment in an order:
1. Open the order details page.
2. Scroll down to the Fulfillment section.
3. Find the fulfillment you want to cancel, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
3. Find the fulfillment you want to cancel, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
4. Click on Cancel Fulfillment in the dropdown.
5. Confirm canceling the fulfillment by clicking the “Yes, confirm” button in the pop-up.
+6 -6
View File
@@ -54,7 +54,7 @@ To edit the shipping address used for an order:
1. Open the order details page.
2. Scroll down to the Customer section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Click on Edit Shipping Address from the dropdown.
5. This opens a new window to edit the shipping address.
6. Once youre done, click on the Save button.
@@ -67,7 +67,7 @@ To edit the email address associated with an order:
1. Open the order details page.
2. Scroll down to the Customer section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Click on Edit Email Address from the dropdown.
5. This opens a new window to edit the email address.
6. Once youre done, click on the Save button.
@@ -79,8 +79,8 @@ To edit the email address associated with an order:
To add a note to an order:
1. Open the order details page.
2. In the Timeline section, enter the note in the text input. You can also choose emojis by clicking the <UiIcon lightIcon="https://i.imgur.com/UwA7Ljp.png" darkIcon="https://i.imgur.com/9lcr16b.png" alt="emoji" /> icon.
3. Once done, click on the <UiIcon lightIcon="https://i.imgur.com/hH4pKe3.png" darkIcon="https://i.imgur.com/QlvPezL.png" alt="send" /> icon.
2. In the Timeline section, enter the note in the text input. You can also choose emojis by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999389/Medusa%20Docs/UI%20Icons/UwA7Ljp_mlt58a.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999407/Medusa%20Docs/UI%20Icons/9lcr16b_e5gcqz.png" alt="emoji" /> icon.
3. Once done, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999420/Medusa%20Docs/UI%20Icons/hH4pKe3_ltdg5o.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999435/Medusa%20Docs/UI%20Icons/QlvPezL_zsyikc.png" alt="send" /> icon.
The note will be added and can be seen in the timeline.
@@ -98,7 +98,7 @@ To delete a note in an order:
1. Open the order details page.
2. In the Timeline section, find the note you want to delete from the timeline.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the note.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the note.
4. Click on Delete from the dropdown.
5. Confirm deleting the note by clicking the “Yes, delete” button in the pop-up.
@@ -115,6 +115,6 @@ Once an order is canceled it cant be undone.
To cancel an order:
1. Open the order details page.
2. In the first section showing the orders number, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> at the top right.
2. In the first section showing the orders number, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> at the top right.
3. Click on Cancel Order from the dropdown.
4. Confirm canceling the order by clicking the “Yes, confirm” button in the pop-up.
+3 -3
View File
@@ -36,7 +36,7 @@ To find return requests of an order:
To request a return for an order:
1. Open the order details page.
2. In the Timeline section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right.
2. In the Timeline section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right.
3. Click on Request Return in the dropdown.
4. In the new window that opens:
- Choose the items in the order that you want to request the return.
@@ -44,7 +44,7 @@ To request a return for an order:
- Choose a Return Reason, optionally enter a Note, then click the Add button.
- Select a shipping method you want to use for this return.
- If you want to change the default price of the shipping method, click on the “Add custom price” button and enter the price you want to use.
- If you want to remove the custom price, you can click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
- If you want to remove the custom price, you can click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
- If you dont want the customer to receive an email that a return has been requested, uncheck the “Send notifications” checkbox.
5. Once done, click on the Submit button.
@@ -79,5 +79,5 @@ If a return is canceled it cant be undone. A return can only be canceled if i
To cancel a return:
1. Open the order details page.
2. In the Timeline section, find the return requested and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Timeline section, find the return requested and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on “Cancel return” in the dropdown.
@@ -25,16 +25,16 @@ When you import prices into a price list, it removes existing prices and adds ne
To import prices into a price list:
1. Go to the price lists details page.
2. In the Prices section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Prices section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on “Import price list” from the dropdown.
4. In the new window:
1. If youre unsure of what the CSV files format must be like, you can download a template CSV file by clicking the <UiIcon lightIcon="https://i.imgur.com/fhRqHS3.png" darkIcon="https://i.imgur.com/HdVNMNy.png" alt="download" /> icon.
1. If youre unsure of what the CSV files format must be like, you can download a template CSV file by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999458/Medusa%20Docs/UI%20Icons/fhRqHS3_kwmafj.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999472/Medusa%20Docs/UI%20Icons/HdVNMNy_qrk8ez.png" alt="download" /> icon.
2. To upload the CSV file you want to import prices from, either:
1. Drag and drop the file into the dashed box;
2. Or click on the dashed box and choose the file you want to import the prices from.
3. After you upload the CSV file:
1. You can check the number of prices to be added above the uploaded files name.
2. You can remove the file you choose by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
2. You can remove the file you choose by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
5. Once youre done choosing a file to import prices from, click on the Import List button.
This starts the import process. Based on the number of prices youre importing, it can take some time.
@@ -49,7 +49,7 @@ If you face any errors or difficulties, please contact your technical support te
To check the status of the import:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the price import, which should be the latest item on the list.
If a loading indicator is showing, then the import process is still in progress.
@@ -70,6 +70,6 @@ You can only cancel an unfinished prices import.
To cancel a price import:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the import you want to cancel.
3. Click on the cancel button.
+12 -12
View File
@@ -45,22 +45,22 @@ In this section, you must choose at least one product and specify the prices you
2. Choose at least one product from the list.
3. Click the Save button. The products will then be seen under the Prices section.
4. For each product you added:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon at its right.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon at its right.
2. To add the same price for all variants:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to any of the variants.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to any of the variants.
2. Choose “Edit Prices” from the dropdown.
3. In the new window, choose the “Apply on all variants” option.
4. Enter the price for each currency.
5. Click on the “Save and close” button.
3. To add a price for each variant:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to a variant.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to a variant.
2. Choose “Edit Prices” from the dropdown.
3. In the new window, choose the “Apply overrides on selected variants” option.
4. Choose the variants that you want to apply the current pricing to.
5. Enter the price for each currency.
6. Click on the “Save and close” button.
4. To remove a variant from the price list:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the variant.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the variant.
2. Click on the Remove from List button.
2. To remove products from the prices list:
1. Click on the “Add Products Manually” button.
@@ -96,7 +96,7 @@ Publishing a price list makes it and its prices available to customers. Unpublis
To change a price lists status:
1. Go to the Pricing page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the price list.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the price list.
3. Based on the current status, click on the Unpublish or Publish links in the dropdown to change the status.
---
@@ -106,7 +106,7 @@ To change a price lists status:
To edit a price lists information and configurations:
1. Go to the price lists details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the first section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the first section.
3. Choose “Edit price list details”.
4. This opens a form in a new window that has the [same sections as the Create Price List form](#create-a-price-list), except for the Prices section. You can edit the price lists general information, customer groups, and start and end dates.
5. Once youre done making changes, click on the Save changes button.
@@ -120,7 +120,7 @@ To edit a price lists information and configurations:
To add new product prices:
1. Go to the price lists details page.
2. In the Prices section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
2. In the Prices section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
3. Click on “Edit manually” in the dropdown.
4. This opens a new window with a form similar to the [Prices section in the Create form](#prices). You can search for or manually add products.
5. Once youre done, click on the “Save changes” button.
@@ -131,11 +131,11 @@ To edit the prices in the price list:
1. Go to the price lists details page.
2. Find the product you want to edit in the Prices section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
4. Choose “Edit prices” from the dropdown.
5. In the new window:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon next to the products name to expand the list of variants.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/RxZhOoi.png" darkIcon="https://i.imgur.com/iKh5Q7h.png" alt="right arrow" /> icon next to the variant you want to edit.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon next to the products name to expand the list of variants.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999494/Medusa%20Docs/UI%20Icons/RxZhOoi_sismq2.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999509/Medusa%20Docs/UI%20Icons/iKh5Q7h_iuwp7r.png" alt="right arrow" /> icon next to the variant you want to edit.
3. Edit the prices of the variant for each currency.
4. Once youre done, click on the “Save and close” button.
6. Once youre done editing the products prices, click on the Save button.
@@ -152,7 +152,7 @@ To delete all the prices of a product in a price list:
1. Go to the price lists details page.
2. Find the product you want to edit in the Prices section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to it.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to it.
4. Click on “Remove product” in the dropdown.
---
@@ -168,6 +168,6 @@ Deleting a price list cannot be undone. Prices defined in the price list will no
To delete a price list:
1. Go to the Pricing page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the price list you want to delete.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the price list you want to delete.
3. Click on Delete in the dropdown.
4. Confirm deleting the price list by clicking the “Yes, confirm” button in the pop-up.
@@ -19,7 +19,7 @@ To create a collection:
1. You're required to enter a name for the collection
2. You can optionally specify the handle of the collection.
3. To add metadata, click on the Add Metadata button.
4. To remove metadata, click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon next to it.
4. To remove metadata, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon next to it.
5. Once done, click on the “Publish collection” button.
---
@@ -39,7 +39,7 @@ To view a collections details:
To edit a collection:
1. Go to the Collections Details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the first section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the first section.
3. Choose Edit Collection from the dropdown.
4. In the new form that opens, edit any of the collection details.
5. Once done, click on the “Save collection” button.
@@ -69,7 +69,7 @@ To remove a product from a collection:
1. Go to the Collections Details page.
2. In the Products section, find the product you want to remove from the collection.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon at the right side of the product.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon at the right side of the product.
4. Confirm removing the product by clicking the “Yes, remove" button in the pop-up.
---
@@ -85,6 +85,6 @@ Deleting a collection cant be undone. You will lose all data related to the c
To delete a collection:
1. Go to the Collections page.
2. Find the collection you want to delete, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the collection you want to delete, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Choose Delete from the dropdown.
4. Confirm deleting the collection by clicking the “Yes, confirm" button in the pop-up.
+3 -3
View File
@@ -21,7 +21,7 @@ To export products:
1. Go to the Products page.
2. Click on Export Products at the top right.
3. Click Export in the window that opens.
4. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
4. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
5. You should see your new export loading.
6. Once the export is ready, click on the Download button.
@@ -43,7 +43,7 @@ You can only cancel an unfinished product export.
To cancel a product export:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the export you want to cancel.
3. Click on the cancel button.
@@ -59,6 +59,6 @@ You can only delete a finished product export.
To delete a product export:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the export you want to delete.
3. Click on the Delete button.
+4 -4
View File
@@ -23,13 +23,13 @@ To import products:
1. Go to the Products page.
2. Click on Import Products at the top right.
3. In the new window:
1. If youre unsure of what the CSV files format must be like, you can download a template CSV file by clicking the <UiIcon lightIcon="https://i.imgur.com/fhRqHS3.png" darkIcon="https://i.imgur.com/HdVNMNy.png" alt="download" /> icon.
1. If youre unsure of what the CSV files format must be like, you can download a template CSV file by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999458/Medusa%20Docs/UI%20Icons/fhRqHS3_kwmafj.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999472/Medusa%20Docs/UI%20Icons/HdVNMNy_qrk8ez.png" alt="download" /> icon.
2. To upload the CSV file you want to import products from, either:
1. Drag and drop the file into the dashed box;
2. Or click on the dashed box and choose the file you want to import the products from.
3. After you upload the CSV file:
1. You can check the number of products to be created or updated above the uploaded files name.
2. You can remove the file you choose by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
2. You can remove the file you choose by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
4. Once youre done choosing a file to import products from, click on the Import List button.
This starts the import process. Based on the number of products youre importing, it can take some time.
@@ -44,7 +44,7 @@ If you face any errors or difficulties, please contact your technical support te
To check the status of the import:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the product import, which should be the latest item on the list.
If a loading indicator is showing, then the import process is still in progress.
@@ -65,6 +65,6 @@ You can only cancel an unfinished product import.
To cancel a product import:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/mWhpxNX.png" darkIcon="https://i.imgur.com/tE8LOXk.png" alt="bell" /> icon at the top right of the page.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999016/Medusa%20Docs/UI%20Icons/mWhpxNX_xteuos.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999044/Medusa%20Docs/UI%20Icons/tE8LOXk_puyrib.png" alt="bell" /> icon at the top right of the page.
2. Find the import you want to cancel.
3. Click on the cancel button.
+2 -2
View File
@@ -30,11 +30,11 @@ In the list, you can see product details such as the name, collection, inventory
### List View
To view products in a list view, which is the default view, click on the <UiIcon lightIcon="https://i.imgur.com/A4kBy4n.png" darkIcon="https://i.imgur.com/y50COcH.png" alt="list" /> icon at the top right of the product list.
To view products in a list view, which is the default view, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999530/Medusa%20Docs/UI%20Icons/A4kBy4n_da3gud.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999544/Medusa%20Docs/UI%20Icons/y50COcH_dby5ol.png" alt="list" /> icon at the top right of the product list.
### Grid View
To view products in a grid view, click on the <UiIcon lightIcon="https://i.imgur.com/HXMOOzK.png" darkIcon="https://i.imgur.com/fAHh3vz.png" alt="grid" /> icon at the top right of the product list.
To view products in a grid view, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999559/Medusa%20Docs/UI%20Icons/HXMOOzK_mfmw9o.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999573/Medusa%20Docs/UI%20Icons/fAHh3vz_etj57w.png" alt="grid" /> icon at the top right of the product list.
---
+23 -23
View File
@@ -30,26 +30,26 @@ All fields in this section allow you to better group and filter your products us
1. You can either choose from a list of types or create a new one.
2. You can choose from a list of collections.
3. Tags are comma-separated. After entering a tags value, add a comma “,” and it will create the tag. You can remove the tag by pressing the <UiIcon lightIcon="https://i.imgur.com/kvGRHQR.png" darkIcon="https://i.imgur.com/RJ4SLIu.png" alt="X" /> icon next to it.
3. Tags are comma-separated. After entering a tags value, add a comma “,” and it will create the tag. You can remove the tag by pressing the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999180/Medusa%20Docs/UI%20Icons/kvGRHQR_s0ptsm.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999200/Medusa%20Docs/UI%20Icons/RJ4SLIu_n30zqr.png" alt="X" /> icon next to it.
### Variants Section
In this section, you can create different options and variants of a product. You must add an option before you can add variants.
1. Add a new option by clicking the “Add an option” button.
1. This shows two new fields: the Title and the Variations fields. Separate the variations using a comma “,”. You can remove a variation by clicking the <UiIcon lightIcon="https://i.imgur.com/kvGRHQR.png" darkIcon="https://i.imgur.com/RJ4SLIu.png" alt="X" /> icon next to it.
2. To remove an option, click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon next to it.
1. This shows two new fields: the Title and the Variations fields. Separate the variations using a comma “,”. You can remove a variation by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999180/Medusa%20Docs/UI%20Icons/kvGRHQR_s0ptsm.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999200/Medusa%20Docs/UI%20Icons/RJ4SLIu_n30zqr.png" alt="X" /> icon next to it.
2. To remove an option, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon next to it.
2. Add a new variant by clicking the “Add a variant” button. In the new window that opens:
1. Enter the required fields Custom title and choose a value for each option you created.
2. In the Pricing section, you can specify the price for each currency. To specify the price per region:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/A91y4rk.png" darkIcon="https://i.imgur.com/knwwocb.png" alt="right arrow" /> icon next to the currency. This expands a list of regions below the currency. These are regions that use this currency.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999595/Medusa%20Docs/UI%20Icons/A91y4rk_doqj9s.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999615/Medusa%20Docs/UI%20Icons/knwwocb_ll4l6m.png" alt="right arrow" /> icon next to the currency. This expands a list of regions below the currency. These are regions that use this currency.
2. Enter the price for the region you want.
3. In the Stock & Inventory section, you can manage how Medusa handles the products inventory, the quantity in stock, and more.
1. If Manage Inventory is enabled, Medusa will change the available quantity of the variant when orders or returns are made.
2. If Allow Backorders is enabled, customers can purchase this variant even if its out-of-stock.
4. In the Shipping section, you can specify information relevant to shipping such as Height, Weight, Country of origin, and more.
3. You can edit a variant by clicking the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon, then choosing Edit from the dropdown.
4. You can delete a variant by clicking the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon, then choosing Delete from the dropdown.
3. You can edit a variant by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon, then choosing Edit from the dropdown.
4. You can delete a variant by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon, then choosing Delete from the dropdown.
### Attributes Section
@@ -67,7 +67,7 @@ You can upload only one thumbnail. Uploading another thumbnail replaces the prev
1. Click the dashed box and choose an image;
2. Or drag-and-drop an image in the dashed box.
2. To delete a thumbnail:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
2. Click Delete from the dropdown.
### Media Section
@@ -82,7 +82,7 @@ You can upload more than one image in the Media section.
1. Click the dashed box and choose an image;
2. Or drag-and-drop an image in the dashed box.
2. To delete an image:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
2. Click Delete from the dropdown.
### Save the Product
@@ -104,7 +104,7 @@ To view a products details:
To edit a products general information:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> at the top right of the first section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> at the top right of the first section.
3. Click on “Edit General Information” from the dropdown.
4. Edit any of the information in the window.
5. Once done, click on the Save button.
@@ -130,12 +130,12 @@ After a product is created, the only way to add values to an option is when you
To manage a products option:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the top right of the Variants section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the top right of the Variants section.
3. Click on Edit Options from the dropdown.
4. In the new window that opens:
1. You can add a new option by clicking the “Add an option” button.
2. You can edit an options name by changing its name in the field.
3. You can delete an option by clicking the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon.
3. You can delete an option by clicking the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon.
5. Once youre done, click on the "Save and close" button.
## Manage Product Variants
@@ -151,13 +151,13 @@ Multiple variants cant have the same options combination.
To add a variant to a product:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the top right of the Variants section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the top right of the Variants section.
3. Click on Add Variant from the dropdown.
4. In the window that opens:
1. Enter the required title field.
2. Choose a value for each option in the product.
3. In the Pricing section, you can specify the price for each currency. To specify the price per region:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/A91y4rk.png" darkIcon="https://i.imgur.com/knwwocb.png" alt="right arrow" /> icon next to the currency. This expands a list of regions below the currency. These are regions that use this currency.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999595/Medusa%20Docs/UI%20Icons/A91y4rk_doqj9s.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999615/Medusa%20Docs/UI%20Icons/knwwocb_ll4l6m.png" alt="right arrow" /> icon next to the currency. This expands a list of regions below the currency. These are regions that use this currency.
2. Enter the price for the region you want.
4. In the Stock & Inventory section, you can manage how Medusa handles the products inventory, the quantity in Stock, and more.
1. If Manage Inventory is enabled, Medusa will change the available quantity of the variant when orders or returns are made.
@@ -170,10 +170,10 @@ To add a variant to a product:
To edit variants position in a product:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the top right of the Variants section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the top right of the Variants section.
3. Click on Edit Variants from the dropdown.
4. In the window that opens:
1. Click and hold the <UiIcon lightIcon="https://i.imgur.com/zp2QTbO.png" darkIcon="https://i.imgur.com/ZPpOcvi.png" alt="three dots" /> icon next to the variant, then drag it to the position you want.
1. Click and hold the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999654/Medusa%20Docs/UI%20Icons/zp2QTbO_io0f7i.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999668/Medusa%20Docs/UI%20Icons/ZPpOcvi_h14vyz.png" alt="grip" /> icon next to the variant, then drag it to the position you want.
2. You can also change the inventory of the variants.
5. Once youre done, click on the “Save and close” button.
@@ -183,7 +183,7 @@ To edit a variant:
1. Go to the products details page.
2. Find the variant you want to edit in the Variants section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Click on Edit Variant from the dropdown.
5. In the new window that opens, you can edit all of the variants information.
6. Once youre done, click on the “Save and close” button.
@@ -194,7 +194,7 @@ To duplicate a variant:
1. Go to the products details page.
2. Find the variant you want to duplicate in the Variants section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Click on Duplicate Variant from the dropdown.
5. This opens a new window with almost all fields filled except for the selected Options.
6. Once youre done, click on the “Save and close” button.
@@ -211,7 +211,7 @@ To delete a variant:
1. Go to the products details page.
2. Find the variant you want to duplicate in the Variants section.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Click on Delete Variant from the dropdown.
## Edit a Products Attributes
@@ -219,7 +219,7 @@ To delete a variant:
To edit a products attributes:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon in the top right of the Attributes section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon in the top right of the Attributes section.
3. Click on Edit Attributes from the dropdown.
4. In the new window that opens, you can edit any of the attribute information of the product.
5. Once youre done, click on the Save button.
@@ -254,7 +254,7 @@ Deleting a thumbnail cant be undone.
To delete a thumbnail:
1. Go to the products details page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/7hztVhj.png" darkIcon="https://i.imgur.com/1yp4PNt.png" alt="trash" /> icon at the top right of the Thumbnail section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999273/Medusa%20Docs/UI%20Icons/7hztVhj_mj6mxu.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999290/Medusa%20Docs/UI%20Icons/1yp4PNt_vzwnhf.png" alt="trash" /> icon at the top right of the Thumbnail section.
3. Click the Confirm button.
## Manage Images
@@ -274,7 +274,7 @@ To manage a products images
1. Click the dashed box and choose an image;
2. Or drag-and-drop an image in the dashed box.
2. To delete an image:
1. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
1. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
2. Click on Delete from the dropdown.
4. Once youre done, click Save and close.
@@ -283,7 +283,7 @@ To manage a products images
To duplicate a product:
1. Go to the Products page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the product you want to duplicate.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the product you want to duplicate.
3. Click on Duplicate from the dropdown.
This creates a product with the same information as the original but as a draft.
@@ -299,6 +299,6 @@ Deleting a product cant be undone. Youll lose all the product information.
To delete a product:
1. Go to the Products page.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the product you want to delete.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the product you want to delete.
3. Click on Delete from the dropdown.
4. Confirm deleting the product by clicking the “Yes, confirm” button in the pop-up.
+3 -3
View File
@@ -24,7 +24,7 @@ This opens the Regions page where you can find a list of regions.
To create a region:
1. Go to Settings → Regions.
2. Click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon at the top right of the Regions section.
2. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon at the top right of the Regions section.
3. In the form that opens you must enter the Regions details:
- It is required to enter a title, choose a currency, enter a tax rate, and at least choose one country, payment provider, and fulfillment provider.
- You can optionally enter a tax code for the region. Alternatively, you can [edit a regions tax settings](../taxes/manage.md#edit-a-regions-taxes) after creation.
@@ -46,7 +46,7 @@ To edit a region's basic information:
1. Go to Settings → Regions.
2. Click on the region you want to edit from the Regions section. This shows sections to the right to edit different information and data related to the region.
4. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the first region.
4. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the first region.
5. This opens a new window where you can edit the region's details.
6. Once done, click on the "Save and close" button.
@@ -64,6 +64,6 @@ To delete a region:
1. Go to Settings → Regions.
2. Click on the region you want to duplicate from the Regions section.
3. In the first section on the right, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. In the first section on the right, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose Delete Region from the dropdown list.
5. Confirm deleting the region by clicking the “Yes, confirm" button in the pop-up.
@@ -23,7 +23,7 @@ To add or remove a payment provider in a region:
1. Go to Settings → Regions.
2. Select a region to edit.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the first section on the right.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the first section on the right.
4. Click on Edit Region Details from the dropdown.
5. Under the providers section, select the payment providers you want to add to the region.
6. Unselect the payment providers you want to remove from the region.
@@ -37,7 +37,7 @@ To add or remove a fulfillment provider in a region:
1. Go to Settings → Regions.
2. Select a region to edit.
3. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the top right of the first section on the right.
3. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the top right of the first section on the right.
4. Click on Edit Region Details from the dropdown.
5. Under the providers section, select the fulfillment providers you want to add to the region.
6. Unselect the fulfillment providers you want to remove from the region.
@@ -61,7 +61,7 @@ To delete a shipping option:
1. Go to Settings → Regions.
2. Select a region to edit.
3. Scroll down to the Shipping Options section on the right side.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
5. Click on Delete in the dropdown.
---
@@ -92,7 +92,7 @@ To edit a return shipping option:
1. Go to Settings → Regions.
2. Select a region to edit.
3. Scroll down to the Return Shipping Options section on the right side.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
5. Click on Edit in the dropdown.
6. A new window will open with the fields that you can edit. You can edit all of the fields you chose while adding the shipping option except for the Shipping Profile and Fulfillment Method.
7. Once youre done, click the Save and close button.
@@ -110,5 +110,5 @@ To delete a return shipping option:
1. Go to Settings → Regions.
2. Select a region to edit.
3. Scroll down to the Return Shipping Options section on the right side.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
4. Find the shipping option you want to edit and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
5. Click on Delete in the dropdown.
@@ -24,10 +24,10 @@ This opens the Sales Channels page where you can see the list of Sales channels
To search sales channels:
1. Go to Settings → Sales Channels
2. In the Sales Channels section on the left, click on the <UiIcon lightIcon="https://i.imgur.com/k0U0wpO.png" darkIcon="https://i.imgur.com/IdKjFak.png" alt="magnifier" /> icon next to the title of the section.
2. In the Sales Channels section on the left, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999227/Medusa%20Docs/UI%20Icons/k0U0wpO_pizpfd.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999249/Medusa%20Docs/UI%20Icons/IdKjFak_ultvmh.png" alt="magnifier" /> icon next to the title of the section.
3. This shows an input to search sales channels by title and description.
To clear the search, click on the <UiIcon lightIcon="https://i.imgur.com/kvGRHQR.png" darkIcon="https://i.imgur.com/RJ4SLIu.png" alt="X" /> icon in the search input.
To clear the search, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999180/Medusa%20Docs/UI%20Icons/kvGRHQR_s0ptsm.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999200/Medusa%20Docs/UI%20Icons/RJ4SLIu_n30zqr.png" alt="X" /> icon in the search input.
---
@@ -36,7 +36,7 @@ To clear the search, click on the <UiIcon lightIcon="https://i.imgur.com/kvGRHQR
To add a new sales channel:
1. Go to Settings → Sales Channels
2. In the Sales Channels section on the left, click on the <UiIcon lightIcon="https://i.imgur.com/1hL8NiW.png" darkIcon="https://i.imgur.com/8LtkPqW.png" alt="plus" /> icon next to the title of the section.
2. In the Sales Channels section on the left, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999131/Medusa%20Docs/UI%20Icons/1hL8NiW_lqmjcq.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999150/Medusa%20Docs/UI%20Icons/8LtkPqW_jyqz5i.png" alt="plus" /> icon next to the title of the section.
3. The form to create a new sales channel will open. The name of the sales channel is required, but the description is optional.
4. Once youre done, you can either:
- Click Save as draft to save the sales channel as disabled.
@@ -52,7 +52,7 @@ To enable or disable a sales channel:
1. Go to Settings → Sales Channels
2. In the sales channels list on the left, choose the sales channel you want to enable/disable.
3. At the top right of the right section, you can find the status of the sales channel, with a <UiIcon lightIcon="https://i.imgur.com/yrTcDO4.png" darkIcon="https://i.imgur.com/yrTcDO4.png" alt="green" /> icon if its enabled or a <UiIcon lightIcon="https://i.imgur.com/0lUln3B.png" darkIcon="https://i.imgur.com/0lUln3B.png" alt="grey" /> icon if its disabled.
3. At the top right of the right section, you can find the status of the sales channel, with a <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999685/Medusa%20Docs/UI%20Icons/yrTcDO4_tulwph.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999685/Medusa%20Docs/UI%20Icons/yrTcDO4_tulwph.png" alt="green" /> icon if its enabled or a <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999700/Medusa%20Docs/UI%20Icons/0lUln3B_arpgmo.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999700/Medusa%20Docs/UI%20Icons/0lUln3B_arpgmo.png" alt="grey" /> icon if its disabled.
4. Click on the status, and a dropdown will show to toggle the status. For example, if the status of the sales channel is Enabled, the dropdown will show a Disabled status.
5. Choose the status in the dropdown, and the status of the sales channel will change.
@@ -64,7 +64,7 @@ To edit a sales channels information:
1. Go to Settings → Sales Channels
2. In the sales channels list on the left, choose the sales channel you want to edit.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose from the dropdown list “Edit general info”.
5. This opens a form in a window where you can edit the name and description of the sales channel.
6. Once done, click Save.
@@ -83,6 +83,6 @@ To delete a sales channel:
1. Go to Settings → Sales Channels
2. In the sales channels list on the left, choose the sales channel you want to delete.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose from the dropdown list “Delete channel”.
5. Confirm deleting the tax rate by clicking the “Yes, delete” button in the pop-up.
@@ -21,7 +21,7 @@ To add products to a sales channel:
1. Go to Settings → Sales Channels
2. In the sales channels list on the left, choose the sales channel you want to add products to.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. At the top right of the right section, click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose from the dropdown list “Add products”.
5. This opens a window to add products with filters and search functionalities similar to those of a product page. Select the products you want to add to the sales channel.
6. Click Save.
@@ -47,5 +47,5 @@ To remove a product from a sales channel:
1. Go to Settings → Sales Channels
2. In the sales channels list on the left, choose the sales channel you want to remove the product from.
3. Find the product you want to remove from the sales channel.
4. Click the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at the right side of the products row.
4. Click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at the right side of the products row.
5. Choose from the dropdown list “Remove from the channel”.
@@ -49,9 +49,9 @@ To edit an override:
1. Go to Settings → Taxes
2. Select the region that the tax rate you want to edit belongs to.
3. From the list of tax rates in the Details section, find the tax rate that the override you want to edit belongs to and click the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. From the list of tax rates in the Details section, find the tax rate that the override you want to edit belongs to and click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Under the overrides section, find the override type you want to edit. For example, if you want to add a product to the overrides, find the override with the title “Product Rules”.
5. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the override type.
5. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the override type.
6. Choose Edit from the dropdown.
7. You can then change the selected entries for the override type.
8. Once done, click Add.
@@ -71,8 +71,8 @@ To delete an override:
1. Go to Settings → Taxes
2. Select the region that the tax rate you want to edit belongs to.
3. From the list of tax rates in the Details section, find the tax rate that the override you want to delete belongs to and click the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. From the list of tax rates in the Details section, find the tax rate that the override you want to delete belongs to and click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Under the overrides section, find the override type you want to delete.
5. Click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon next to the override type.
5. Click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon next to the override type.
6. Choose “Delete rule” from the dropdown.
7. Click Save.
+2 -2
View File
@@ -33,7 +33,7 @@ To edit a tax rate:
1. Go to Settings → Taxes
2. Select the region that the tax rate you want to edit belongs to.
3. From the list of tax rates in the Details section, find the tax rate you want to edit and click the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. From the list of tax rates in the Details section, find the tax rate you want to edit and click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose Edit from the dropdown.
5. In the form that opens in the new window, you can edit the basic details of the tax rate such as the name or rate. If youre editing a tax rate thats not the default, you can [manage overrides of this tax rate](./tax-overrides.mdx).
6. Once done, click Save.
@@ -52,7 +52,7 @@ To delete a tax rate:
1. Go to Settings → Taxes
2. Select the region that the tax rate you want to delete belongs to.
3. From the list of tax rates in the Details section, find the tax rate you want to delete and click the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon.
3. From the list of tax rates in the Details section, find the tax rate you want to delete and click the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon.
4. Choose Delete Tax Rate from the dropdown.
5. Confirm deleting the tax rate by clicking the “Yes, confirm” button in the pop-up.
+5 -5
View File
@@ -32,7 +32,7 @@ If you want the user to receive a new email with the invite link, you can resend
To resend an invite to a user:
1. Go to your team page.
2. Find the user that you want to resend an invite to, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the user that you want to resend an invite to, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Click on Resend Invitation from the dropdown.
### Get Invite Link
@@ -42,7 +42,7 @@ In addition to sending the user an invite, you can copy the invite link and send
To copy the invite link:
1. Go to your team page.
2. Find the user invite, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the user invite, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Click on “Copy invite link” from the dropdown.
### Remove Invite
@@ -56,7 +56,7 @@ Removing an invite would prevent the invited user from joining the team, even if
To remove an invite:
1. Go to your team page.
2. Find the user invite, then click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the user invite, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Click on “Remove invitation” from the dropdown.
4. Confirm removing the invitation by clicking the “Yes, remove” button in the pop-up.
@@ -65,7 +65,7 @@ To remove an invite:
To edit a users details in your team:
1. Go to your team page.
2. Find the user and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the user and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. In the new form, edit any of the users information.
4. Once done, click on the Save button.
@@ -80,6 +80,6 @@ Removing a user from a team cant be done. The users details will be lost.
To remove a user from your team:
1. Go to your team page.
2. Find the user and click on the <UiIcon lightIcon="https://i.imgur.com/1ordBC6.png" darkIcon="https://i.imgur.com/dSwWYBH.png" alt="three dots" /> icon at its right.
2. Find the user and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
3. Click on Remove User from the dropdown.
4. Confirm removing the user by clicking the “Yes, remove” button in the pop-up.