---
name: sell-service-docs
title: Documenting your service
description: Documenting your service includes providing details about how to use your product and making sure that users can find these instructions by providing a link from the IBM Cloud catalog.
last-updated: 2026-04-08
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/sell?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Documenting your service
{: #service-docs}

Documenting your service includes providing details about how to use your product and making sure that users can find these instructions by providing a link from the IBM Cloud catalog.
{: shortdesc}

## Creating your service documentation
{: #create-docs}

As a third party, you must host and publish your service documentation.

It is recommended that you have a topic that covers deploying your service on IBM Cloud. Consider including this as part of a "Getting started" topic in your documentation. Don't redocument the user interface. Instead, guide your users on where to start provisioning your service and cover any details that are not included in the UI text.

From there, make sure that the full use of your product is documented. And don't forget any self-help information like troubleshooting or FAQs. Also consider setting onboarding expectations, especially if your product onboarding is not automated from the console. For example, if onboarding is personalized or requires steps outside of IBM Cloud, outline that process for the user so that they know what to expect next.

## Providing the **Docs** link
{: #view-docs-link}

When a user clicks your service tile in the IBM Cloud catalog, the catalog details page appears for the user to learn more about your product. You want to make sure the **Docs** related link on the page is going to your service documentation.

To add the URL where you're hosting your service documentation, complete the following steps:

1. In the IBM Cloud console, click the **Navigation Menu** icon ![Navigation Menu icon](../icons/icon_hamburger.svg "Menu") > **Partner Center** > **My products** and select your product.
1. Click **Catalog entry**.
1. Click **Add your documentation URL**.
1. Enter the URL and click **Save**.