> For the complete documentation index, see [llms.txt](https://docs.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violet.io/resources/merchant-dashboard.md). # Merchant Dashboard {% hint style="warning" %} If you are a channel testing the merchant dashboard in sandbox, go to Click [here](/resources/merchant-dashboard.md) for more information {% endhint %} The Violet Merchant Dashboard lets your merchants review the state of their connection to Violet Channels, view Orders placed through the system, and configure their payments. ## Sign In Merchants onboard through [Violet Connect](/prism/violet-connect.md), which is an onboarding process tailored to your Channel. Once the onboarding process is complete, they can sign into the [Merchant Dashboard](https://merchant.violet.io) for an Overview of the orders placed through their integration with Violet; change their commission rates; or update payout accounts. Enter the same email address used during Violet Connect onboarding. {% hint style="info" %} If the merchant signs in and sees a screen saying "No Store Connected", that means they have not used the email that is tied to their merchant account. Please make sure they are using the same email they signed up with originally in Violet Connect. {% endhint %} ![](/files/zXVfXmc2fgHUGFulLvru) ## Navigating the Merchant Dashboard There are three main sections to the Merchant Dashboard: 1. Overview (Home) 2. Notifications 3. Messages 4. Commission Rates 5. Payouts 6. Orders 7. Products ### Overview The Overview page is where they can see see information about their connected store, all the Channels they are connected to, and control their commission rates. ![Overview](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336368/mintlify/merchant-dashboard/m-dash-home.png) ### Notifications The Notifications page is where merchants can manage all the notifications that they have received such as from completed report notifications and commission rate updates. ![Notifications Tab](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336367/mintlify/merchant-dashboard/m-dash-notifications.png) ### Messages The Messages tab enables direct communication with your connected channels. From here, you can initiate and manage conversations with channels in real-time. ![Messages Tab](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336368/mintlify/merchant-dashboard/m-dash-messages.png) ### Commission Rates The Commission Rates tab displays historical commission rate changes for the merchant's connected apps. You can:\ \- View a chronological log of all rate changes\ \- Filter changes by specific channels ![Commission Rates Tab](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336367/mintlify/merchant-dashboard/m-dash-commission-rates.png) ### Payouts The Payouts page is merchants can see all the financial transactions related to their orders. Each payout entry includes:\ \- A detailed summary of the transaction\ \- Related distribution records\ \- Transaction status and timeline\ \- They can also access a dedicated Distributions tab for a more comprehensive view of money earned across orders. ![Payouts Tab](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336369/mintlify/merchant-dashboard/m-dash-payouts.png) #### Distributions Tab The Distributions tab provides a comprehensive view of all distributions across your orders. ![Distributions Tab](/files/O3yR7h4CRc8y8VITcsgU) You can click on any distribution to view its details. ![Distribution Detail](/files/2vqtI52ZVsbpav3Vk79S) #### Transfers Tab The Transfers tab shows all transfers associated with your payouts. ![Transfers Tab](/files/9fhNqK7bsXoYjH39SOBE) You can click on any transfer to view its details. ![Transfer Detail](/files/ILcFG0Gh0ONWl8RebLEU) ### Orders The Orders dashboard is where they can see all orders that have been placed through their integrations with Violet, including the state that they are in. ![Orders Tab](/files/isThrDVypxtDvU39CXh5) #### Adding Fulfillment & Tracking Details When you select an order, the detail view shows your items in two sections: * **Unfulfilled** — items that have not yet been shipped. * **Fulfilled** — items that have been shipped, along with their tracking details. **Adding Tracking** 1. Open an order and click **+ Add Tracking** in the Unfulfilled section. 2. Review the order summary (order number, date, and shipping address). 3. In the **Items** section, confirm the quantity of each item you are shipping. You can adjust quantities to create a partial fulfillment if you are shipping items in multiple shipments. 4. Under **Tracking**, fill in the required fields: * **Carrier** (required) — select from the dropdown: UPS, USPS, FedEx, DHL, OnTrac, Royal Mail, Sendle, PostNord, Yun Express, or Other. * **Tracking Number** (required) — enter the tracking number provided by the carrier. * **Tracking URL** (optional) — enter a direct link to the tracking page. 5. Click **Add Tracking** to submit. The items move to the Fulfilled section, where you and your connected channels can view the carrier, tracking number, and tracking link. **Editing Tracking** To update tracking details for an already-fulfilled shipment, click the **pencil icon** next to the tracking number in the Fulfilled section. In the Edit Tracking modal, you can change the carrier, tracking number, or tracking URL, then click **Save Changes**. **Partial Fulfillment** If you are shipping an order in multiple packages, you can fulfill a subset of items at a time. Each time you add tracking, only the remaining unfulfilled items are shown. Repeat the process for each shipment until all items are fulfilled. ### Products (Publishing) The Products page is where they can see all the products that they have synced into Violet. Here they can `Publish` or `Unpublish` products to sell through your Channel. {% hint style="info" %} Unpublishing a product makes it inaccessible to any connected channel. An product that is 'published' simply means that it is accessible to a Channel. Violet maps statuses from their e-commerce platform and honors configurations that set a product to disabled, not for sale, out of stock, hidden, archived, etc.\ Just because a product is published does not mean that a channel will be able to purchase that product. {% endhint %} ![Products Tab](/files/pOmOac3uGoBE4eDaDm3k) ## Account Settings To access and modify account settings, they can click on “Violet User” in the bottom left corner and click Settings. ![Account settings link](https://res.cloudinary.com/ddhjp8mca/image/upload/v1742336372/mintlify/merchant-dashboard/m-dash-account-settings-link.png) Here, you can navigate to the payouts tab to manage your payout account settings. For more information on how to setup and manage payout accounts, please see [this guide](/prism/payments/payouts/prism-payout-accounts.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.violet.io/resources/merchant-dashboard.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.