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

# Understanding the Services Page

> This help topic describes the Services page and its features for partners and managed account users.

export const Anchor = ({name}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Anchor -';
  if (name === undefined || name === null || name === 'undefined') {
    console.error(`${errorPrefix} \`name\` must have a value — rendering an empty string instead`);
    return <></>;
  }
  const raw = typeof name === 'string' ? name : JSON.stringify(name);
  const id = raw.replace(/\s+/g, '-').replace(/[^A-Za-z0-9_-]/g, '').replace(/-+/g, '-').replace(/^-+|-+$/g, '');
  if (!id) {
    console.error(`${errorPrefix} \`name\` "${name}" sanitizes to an empty id — rendering an empty string instead`);
    return <></>;
  }
  return <a style={{
    scrollMarginTop: 'var(--scroll-mt)'
  }} id={id}></a>;
};

export const Image = ({src, alt = '', caption, width, height, shadow}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  const img = <img className={['mega-image-style', shadow ? 'shadow' : ''].join(' ')} src={src} alt={alt} width={width} height={height} style={{
    display: 'block'
  }} />;
  return caption ? <figure>
      {img}
      <figcaption style={{
    textAlign: 'center',
    width
  }}>{caption}</figcaption>
    </figure> : img;
};

export const InlineIcon = ({icon, label}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: InlineIcon -';
  if (typeof icon !== 'string') {
    console.error(`${errorPrefix} the \`icon\` property must be a string — rendering an empty string instead`);
    return <></>;
  }
  const iconMapping = {
    edit: 'pencil-to-square',
    delete: 'trash',
    plus: 'plus',
    diagnostics: 'wave-pulse',
    details: 'gear',
    'looking-glass': 'binoculars',
    move: 'arrow-left-arrow-right',
    map: 'location-dot',
    more: 'ellipsis-vertical',
    lock: 'unlock-keyhole',
    key: 'key',
    add: 'circle-plus',
    terminal: 'terminal',
    restart: 'arrow-rotate-right',
    filters: 'sliders-simple',
    monitor: 'wave-pulse',
    dashboard: 'gauge',
    services: 'server',
    marketplace: 'store',
    tools: 'screwdriver-wrench',
    'service-status': 'heart-pulse',
    cart: 'cart-shopping',
    help: 'circle-question'
  };
  const iconAliases = {
    settings: iconMapping['details'],
    location: iconMapping['map'],
    'service-key': iconMapping['key'],
    'console-access': iconMapping['terminal']
  };
  const allIcons = {
    ...iconMapping,
    ...iconAliases
  };
  if (!allIcons[icon]) {
    console.error(`${errorPrefix} unrecognized icon name "${icon}" — rendering an empty string instead`);
    return <></>;
  }
  const iconElement = <Icon icon={allIcons[icon]} iconType="regular" className="prose bg-gray-500" />;
  return label ? <span role="img" aria-label={label}>
      {iconElement}
    </span> : iconElement;
};

The Services page is a bird's eye view of all your Megaport services. You can view, configure, and edit your Ports, MCRs, MVEs, and their connections (VXCs, IXs, and Megaport Internet connections). Each connection is grouped under its associated Port, MCR, or MVE.

Partners can view, configure, and edit all services including Ports, MCRs, MVEs, and their connections (VXCs, IXs, and Megaport Internet) within both their own account and all of their managed accounts.

<Image src="/images/partners/partner-portal-services.png" alt="Partner Portal Services" shadow={true} width={800} />

Managed account users can view, configure, and edit all services including Ports, MCRs, MVEs, and their connections (VXCs, IXs, and Megaport Internet) within their own managed account.

<Image src="/images/partners/managed-portal-services.png" alt="Managed Account Portal Services" shadow={true} width={800} />

For more information, see [Understanding the Services Page](https://docs.megaport.com/portal-admin/services-page/).

<Anchor name="filter" />

## Filtering and sorting services

The filtering and sorting tools allow you to customize the Services page to help you find the information you need.

This feature is available to both partners and managed account users.

<Image src="/images/portal-admin/services-filter-sort.png" alt="Filtering and sorting services options" shadow={true} width={700} />

## Filtering services

To narrow the services shown on the page, enter your text search in the **Filter Services** field. The filter will match against the name, location, and ID of the services. Any services matching your search will be highlighted.

Click <InlineIcon icon="filters" label="View additional filters button for filtering by service type and contract term type" />(View Additional Filters) to filter services by service type and contract term length, in addition to the text filter. For example, you can filter on Ports on a 12 month term. The filters will persist if you navigate away and return to the Services page in the same session.

The number of matching services is displayed below the **Filter Services** field. Click **Clear Filters** to remove all filters and display all services in the Services page.

### Sorting services

You can change the order of the items on the Services page according to the following criteria:

* **Creation Date** -- Sorts by the date they were created.
* **Name** -- Sorts by name, in alphabetic order.
* **Location** -- Sorts by country, and then by the location within that country.

You can sort in ascending or descending order.

<Note>
  You can only sort Ports, MCRs, and MVEs, not their connections (such as VXCs or IXs), which are displayed in the order they were added.
</Note>

You can also hide or show all the connections for a Port, MCR, or MVE. By default, the Portal shows all the connections unless there are more than 10, in which case they are collapsed initially. Click the Extra Actions kebab menu and select Expand All Services
to expand all connections under a service, or select Collapse All Services to hide them.

<Anchor name="service-inventory" />

## Downloading a service inventory

The Services page provides a convenient way to get an inventory of all services associated with your account. The inventory includes all live and configured services, along with any services that have been decommissioned.

Partners can download an inventory of all services including Ports, MCRs, MVEs, and their connections (VXC, IXs, and Megaport Internet) within both their own account and all of their managed accounts.
Managed account users can download an inventory of all services including Ports, MCRs, MVEs, and their connections (VXC, IXs, and Megaport Internet), within their own managed account.

**To download an inventory of services**

* On the Services page, click <InlineIcon icon="more" label="Extra Actions Kebab menu on the far right of the Services page with an option for downloading a service inventory" />(Extra Actions) > Download Inventory Report.\
  The service inventory is saved in the comma-separated values (CSV) file format and downloaded to your Downloads folder.

Partner: Sample CSV

<Image src="/images/partners/partner-csv.png" alt="Partner CSV" shadow={true} height={400} width={1000} />

Managed account: Sample CSV

<Image src="/images/partners/managed-csv.png" alt="Managed CSV" shadow={true} height={400} width={1000} />

* You can import the CSV data into spreadsheets and databases.
* You can open the CSV file in any text editor.

## Viewing and editing services

By default, services are listed by the date they were created. VXCs, IXs, and Megaport Internet connections are grouped under each Port, MCR, or MVE.

For more information, see [Viewing and editing services](https://docs.megaport.com/portal-admin/services-page/#viewing-and-editing-services).

## Service details

Each service displays its speed or rate limit, location, and allocation percentage.  Ports might also show a diversity zone.  The allocation percentage reflects the amount of bandwidth defined for the respective service that has been assigned to VXCs.

For more information, see [Service details](https://docs.megaport.com/portal-admin/services-page/#service-details).
