> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mylisting.club/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Dashboard

> The logged-in home for listing owners and customers on a MyListing site.

## **What Is the Account Dashboard?**

Think of it this way:

* **My Account** is the front door. It is a WordPress page that WooCommerce owns.
* **Endpoints** are the rooms behind that door. Each one is a short URL added after `/my-account/`, such as `my-listings` or `orders`.
* **MyListing** fills those rooms with directory tools: listing stats, My Listings, promotions, bookmarks, and claims.
* **WooCommerce** still owns store tools: orders, addresses, payment methods, account details, and logout.

After login, listing owners see stats and listing tools. Users who cannot add listings see a simpler welcome screen with store links only.

MyListing does not ship a separate user dashboard page of its own. The dashboard is WooCommerce My Account, restyled and extended for a directory.

## **How It Relates to WooCommerce**

WooCommerce is required for the Account dashboard. If WooCommerce is inactive, MyListing does not register these account pages.

Here is how the two products share the work:

| **Layer**              | **Who owns it** | **What it does**                                                                                                           |
| :--------------------- | :-------------- | :------------------------------------------------------------------------------------------------------------------------- |
| My Account page        | WooCommerce     | The WordPress page (usually titled **My account**) that holds the `[woocommerce_my_account]` shortcode                     |
| Page assignment        | WooCommerce     | **WooCommerce > Settings > Advanced > My account page**                                                                    |
| Store endpoints        | WooCommerce     | Orders, Downloads, Addresses, Payment methods, Account details, Lost password, Log out                                     |
| Directory endpoints    | MyListing       | My Listings, Promotions, Bookmarks, Claim Requests, and optional My Products                                               |
| Login and registration | Both            | Same forms. **Enable user registration** in Theme Tools stays in sync with **WooCommerce > Settings > Accounts & Privacy** |
| Menu                   | Either          | Auto menu from WooCommerce plus MyListing items, or a custom **Woocommerce Menu** you build in **Appearance > Menus**      |

A typical owner path looks like this:

1. They create an account on My Account (a WooCommerce customer role).
2. They buy a listing package or submit a listing (WooCommerce checkout when paid listings are on).
3. They manage that listing under **My Listings** (a MyListing endpoint on the same account page).
4. They view orders, update a card, or change their password on the WooCommerce endpoints.

<Note>
  MyListing Pro can reshape this menu with [Account Endpoints Manager](/woocommerce#woocommerce-account-endpoints-manager) (reorder, rename, hide, or add custom tabs) and can merge Addresses and Payment methods onto Account details. The [MyListing Dashboard](/mylisting-dashboard) module can hide listing actions and add a help link in the Promote Listing modal.
</Note>

## **Where Users Open the Dashboard**

Users reach My Account from:

* The user menu in the MyListing header (after login)
* Direct URL, usually `https://yoursite.com/my-account/`
* Emails and buttons that say **Go to Dashboard** after a listing is submitted or a package is purchased

The page slug is whatever you assigned under **WooCommerce > Settings > Advanced**. `my-account` is the WooCommerce default. If you change the page slug, every endpoint URL changes with it.

Examples:

* Home (stats): `https://yoursite.com/my-account/`
* My Listings: `https://yoursite.com/my-account/my-listings/`
* Orders: `https://yoursite.com/my-account/orders/`
* One listing's stats: `https://yoursite.com/my-account/?listing=565`

## **What Guests See**

When someone visits My Account while logged out, they see **Sign in**. If **Enable user registration** is on, they also see **Register**.

Registration fields and the optional second account type come from **Theme Tools > User Roles**. Username and password fields hide when WooCommerce is set to generate them automatically.

Lost password uses the WooCommerce endpoint `lost-password` on the same page:

`https://yoursite.com/my-account/lost-password/`

## **What Listing Owners See**

### **My Account (Home)**

The first menu item is labeled **My Account** (WooCommerce calls this screen Dashboard). For users who **Can add listings**, this is the stats overview:

* A greeting that uses the user's first name (or username if no first name is set)
* Optional **Filter by listing** dropdown
* Summary cards: Published Listings, Pending Listings, Active Promotions, Visits this week
* Views, unique views, button-click tracks, devices, countries, the visits chart, referrers, platforms, and browsers

Which cards appear is controlled under **Theme Tools > Listing Stats**, not on the My Account page itself. See [Listing Stats](/listing-stats-101) for those toggles.

Users who cannot add listings get a short welcome note with links to Orders, Addresses, and Account details. They do not see listing stats.

### **My Listings**

Endpoint: `my-listings`

This is the listing owner's workbench. They can filter by keyword, listing type, and status (Published, Pending, Expired, Draft, Pending Payment, and similar). Status cards at the top can show Published, Pending Approval, Pending Payment, and Expired counts.

Each listing row can offer actions such as:

| **Action**                      | **When it appears**                                                                                       |
| :------------------------------ | :-------------------------------------------------------------------------------------------------------- |
| **Edit**                        | Published listings, and pending listings if editing pending submissions is allowed                        |
| **Stats**                       | Published listings. Opens the My Account home with a `listing` query argument, for example `?listing=565` |
| **Promote** or **Promoted**     | Published listings, when promotion packages exist                                                         |
| **Switch Plan**                 | Published listings when paid packages are enabled and switching is allowed                                |
| **Upgrade**                     | Published listings on a Listing Subscription when WooCommerce Subscriptions switching is allowed          |
| **Relist**                      | Expired (and some other non-published) listings                                                           |
| **Duplicate**                   | Published, pending, pending payment, and expired listings                                                 |
| **Unpublish** / **Publish**     | Published or unpublished listings                                                                         |
| **Delete**                      | Most listings except pending payment listings that still have an unpaid order                             |
| **Order details** / **Pay Now** | Pending payment listings tied to an unpaid WooCommerce order                                              |
| **Resume**                      | Draft or preview listings with no pending order                                                           |

The row also shows the current package name, created date, and expiry date when those exist.

### **Promotions**

Endpoint: `promotions`

Owners buy or apply promotion packages that raise a listing's priority on Explore and feeds. The **Promote** action on My Listings opens a package picker. Active promotions also appear as a card on the My Account home.

### **Bookmarks**

Endpoint: `my-bookmarks`

Saved listings the user bookmarked from listing pages or preview cards. Any logged-in user can use this, including people who cannot add listings.

### **Claim Requests**

Endpoint: `claim-requests`

Not shown as its own menu item by default. Owners reach it from the status filter on My Listings (**View Claim Requests**). After someone submits a claim, MyListing can send them here to check status.

### **My Products** (Optional)

Endpoints: `my-products` (menu) and `add-product` (form, hidden from the menu)

These appear only when **Enable Simple Products** is on under **Theme Tools > Theme Options > Shop page**. Listing owners can submit simple WooCommerce products from their account, then attach approved products to a listing.

This is a lightweight vendor tool. It does not pay commissions, notify admins automatically, or separate vendor catalogs. Many sites skip it and use a dedicated vendor plugin instead.

### **Account Details**

Endpoint: `edit-account`

Profile fields allowed for that user role (email, names, bio, profile picture, social networks). If **Can switch role** is on, the **Account type** box appears here so they can switch to the other account type.

### **Direct Messages**

Direct Messages are **not** an Account endpoint. When enabled under **Theme Tools > Direct Messages**, logged-in users get a messaging icon in the header.

## **Account Endpoints**

An **endpoint** is the last part of the My Account URL. WooCommerce appends it to the My Account page. MyListing registers extra endpoints the same way, so they stay inside the account layout and menu.

Default English slugs are listed below. WooCommerce slugs can be changed (or blanked to hide that item) under **WooCommerce > Settings > Advanced > Account endpoints**. MyListing slugs are translation strings. On an English site they match the table.

After you change a WooCommerce endpoint slug, go to **Settings > Permalinks** and click **Save changes** so the new URLs work.

### **MyListing Endpoints**

| **Menu label**     | **URL slug**                              | **In the default menu?**           | **What owners do there**                                                |
| :----------------- | :---------------------------------------- | :--------------------------------- | :---------------------------------------------------------------------- |
| **My Account**     | None. This is the My Account page itself. | Yes (first item)                   | Combined listing stats, or a simple welcome if they cannot add listings |
| **My Listings**    | `my-listings`                             | Yes                                | Manage, edit, promote, relist, and filter their listings                |
| **Promotions**     | `promotions`                              | Yes                                | View and manage promotion packages                                      |
| **Bookmarks**      | `my-bookmarks`                            | Yes                                | Open saved listings                                                     |
| **My Products**    | `my-products`                             | Yes, only if Simple Products is on | List products they submitted                                            |
| **Add a Product**  | `add-product`                             | No (opened from My Products)       | Create or edit a simple product                                         |
| **Claim Requests** | `claim-requests`                          | No (opened from My Listings)       | Check claim status                                                      |

My Listings and Promotions are removed from the menu when that user's role has **Can add listings** turned off.

### **WooCommerce Endpoints**

| **Menu label**      | **Default slug**  | **What customers do there**                                           |
| :------------------ | :---------------- | :-------------------------------------------------------------------- |
| **Orders**          | `orders`          | View order history. A single order uses `view-order`                  |
| **Downloads**       | `downloads`       | File downloads, if any products provide them                          |
| **Addresses**       | `edit-address`    | Billing and (if shipping is on) shipping addresses                    |
| **Payment methods** | `payment-methods` | Saved cards, when a gateway supports saved methods. Hidden if none do |
| **Account details** | `edit-account`    | Name, email, password, and MyListing profile fields                   |
| **Log out**         | `customer-logout` | Sign out                                                              |
| **Lost password**   | `lost-password`   | Reset a password (not a menu item)                                    |

WooCommerce Subscriptions (if installed) adds **Subscriptions** (`subscriptions`) so customers can view and manage recurring listing plans.

<Note>
  To add Support, FAQ, or other custom tabs inside `/my-account/` without a child theme, use MyListing Pro [Account Endpoints Manager](/woocommerce#woocommerce-account-endpoints-manager).
</Note>

## **How the Menu Is Built**

By default, MyListing builds the account menu automatically and sorts it roughly like this:

1. **My Account**
2. **My Listings**
3. **Promotions**
4. **Bookmarks**
5. **My Products** (if Simple Products is on)
6. WooCommerce items: Orders, Downloads, Addresses, Payment methods, Account details
7. **Log out**

If you assign a menu to the **Woocommerce Menu** theme location under **Appearance > Menus**, that custom menu **replaces** the automatic list. You then add each item yourself, including MyListing endpoints such as My Listings and My Products.

The automatic menu is usually enough. Use a custom WooCommerce Menu only when you need a shorter or renamed set of links.

## **Where Admins Configure the Dashboard**

There is no single Account Dashboard screen. Settings live in a few places:

| **Task**                                                           | **Where to go**                                                              |
| :----------------------------------------------------------------- | :--------------------------------------------------------------------------- |
| Assign the My Account page and change WooCommerce endpoint slugs   | **WooCommerce > Settings > Advanced**                                        |
| Turn registration on, set account types, and choose profile fields | **Theme Tools > User Roles**                                                 |
| Choose which stats cards owners see                                | **Theme Tools > Listing Stats**                                              |
| Require accounts, approval, paid listings, and plan switching      | **Listings > Settings**                                                      |
| Enable Simple Products                                             | **Theme Tools > Theme Options > Shop page**, then **Enable Simple Products** |
| Direct Messages icon (not an endpoint)                             | **Theme Tools > Direct Messages**                                            |
| Replace the automatic account menu                                 | **Appearance > Menus**, location **Woocommerce Menu**                        |
| Review paid plans assigned after checkout                          | **Users > Paid Listing Packages**                                            |

## **How the Pieces Fit Together**

A practical example for a local business directory:

1. WooCommerce creates the **My account** page and assigns it under **Advanced**.
2. **Theme Tools > User Roles**: registration is on. The main account type is labeled **Business** and **Can add listings** is on.
3. A new owner registers at `/my-account/`, then submits a Restaurant listing and pays for a Featured plan at checkout.
4. They land back in My Account. The home screen shows one published listing and visit stats.
5. **My Listings** shows the restaurant with **Edit**, **Stats**, **Promote**, and **Switch Plan**.
6. **Orders** shows the package purchase. **Account details** is where they update their display name and profile photo.

A private member on the same site (alternate role, **Can add listings** off) still uses My Account, Bookmarks, Orders, and Account details. They do not see My Listings, Promotions, or listing stats.

## **Helpful Tips**

* **Treat WooCommerce as the foundation.** The dashboard URL, login, orders, and account details all come from WooCommerce. Fix a missing My Account page there first.
* **Leave most WooCommerce endpoints as they are.** Empty a slug only when you truly want to hide Orders, Downloads, or Addresses. Blanking a slug disables that screen.
* **Match the menu to the audience.** If most users never buy physical products, Downloads and shipping Addresses add noise. Hide them in WooCommerce settings or with a custom Woocommerce Menu.
* **Can add listings controls the owner tools.** Turning it off is the cleanest way to give someone a simpler account without custom code.
* **Stats settings change visibility, not tracking.** **Theme Tools > Listing Stats** hides cards. It does not turn visit tracking off.
* **Flush permalinks after slug changes.** If `/my-account/orders/` 404s after you edit an endpoint, save **Settings > Permalinks**.
* **Simple Products is optional and limited.** Turn it on only if you are ready to approve products by hand. It is off by default.
* **Messages stay in the header.** Do not look for an Inbox endpoint under My Account.

## **Quick Reference**

| **I want to...**                                   | **Go to...**                                                                                                |
| :------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |
| Open the owner dashboard                           | Front end **My Account**, or `/my-account/`                                                                 |
| Change the My Account page or store endpoint slugs | **WooCommerce > Settings > Advanced**                                                                       |
| Hide My Listings from a role                       | **Theme Tools > User Roles**, then turn off **Can add listings**                                            |
| Change which stat cards appear                     | **Theme Tools > Listing Stats**                                                                             |
| Let owners switch account type                     | **Theme Tools > User Roles**, then **Can switch role**. Users switch under **My Account > Account details** |
| Add My Products to the account                     | **Theme Tools > Theme Options > Shop page**, then **Enable Simple Products**                                |
| Rebuild the account menu by hand                   | **Appearance > Menus**, then **Woocommerce Menu**                                                           |
| See one listing's stats                            | **My Listings**, then **Stats**, or `/my-account/?listing=565`                                              |
| Check a claim                                      | **My Listings** status filter, then **View Claim Requests** (`/my-account/claim-requests/`)                 |

## **Where to Go Next**

* [Listing Stats](/listing-stats-101): What the home dashboard numbers mean and how to configure the cards.
* [User Roles](/user-roles-101): Registration, **Can add listings**, and what each account type sees in My Account.
* [WooCommerce](/woocommerce-101): Listing packages, subscriptions, checkout, and paid listings.
* [Add Listing Flow](/add-listing-flow-101): How a new listing gets from the form to My Listings.
* [Social Login](/social-login-101): Google or Facebook sign-in, plus Connected Accounts on My Account.

## **Common Questions**

* **Do I need WooCommerce if listings are free?** Yes, for the Account dashboard. MyListing mounts owner tools on WooCommerce My Account even when **Enable Paid Listings** is off. You can hide unused store endpoints.
* **Why is My Account a 404?** The My Account page is missing, unpublished, or not assigned under **WooCommerce > Settings > Advanced**. Confirm the page contains the `[woocommerce_my_account]` shortcode.
* **Why are My Listings and Promotions missing?** That user's role has **Can add listings** off, or you replaced the automatic menu with a **Woocommerce Menu** that does not include those items.
* **Why does Payment methods not appear?** WooCommerce hides it unless an active gateway can save a payment method. Stripe-style gateways usually show it. Bank transfer only setups often do not.
* **Is the dashboard a separate Elementor page?** No. The My Account page is a WooCommerce page. Elementor can style the site chrome around it. Custom tabs inside My Account are a MyListing Pro WooCommerce-module feature, not a second WordPress page you assign as My Account.
* **Where do users edit a listing?** **My Listings**, then **Edit**. That stays on `/my-account/my-listings/` with an `action=edit` query argument. That is not a separate endpoint.
* **Can I rename my-listings in the URL?** The default slug is a translatable string (`my-listings` in English). WooCommerce **Advanced** settings do not include MyListing slugs. Changing them without a translation or Pro endpoints manager is not a theme setting.
* **Why did a new endpoint 404 after I enabled Simple Products?** Save **Settings > Permalinks** once so WordPress registers `my-products` and `add-product`.