> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/suppliers/managing-suppliers/managing-an-individual-supplier.md).

# Managing an Individual Supplier

Managing a supplier's information helps keep supplier information accurate and up to date, making it easier to manage purchasing and maintain reliable supplier records.

Managing an individual supplier's information in Supply’d allows you to keep each supplier’s core business information accurate and up to date. You can review and update details such as the supplier’s company information, account details, payment terms, ordering settings, and other supplier-specific information to ensure their record reflects your current trading arrangements.

This document will guide you through viewing and managing a supplier’s details in Supply’d.

* [#the-suppliers-about-page](#the-suppliers-about-page "mention")
* [#options-for-managing-the-supplier](#options-for-managing-the-supplier "mention")
* [#editing-a-supplier](#editing-a-supplier "mention")
* [#removing-a-supplier](#removing-a-supplier "mention")

***

### The Supplier's About Page

Selecting a supplier will open their **Supplier Profile** page, where you can view and manage their details across the available tabs.

The **About** tab displays the supplier’s key business information, allowing you to quickly view and manage their supplier details and settings.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FD9NFGfd1IFlbNSchUC26%2F1%20-%20Supplier%20About%20Tab.png?alt=media&amp;token=67ddab9b-1b3b-4d64-919d-80a9801e2812" alt=""><figcaption></figcaption></figure>

From the **About** tab, you can view:

* **Account Number** - Your account number with the supplier.
* **Payment Terms** - The payment terms set for the supplier.
* **Currency** - The currency used when purchasing and placing orders with the supplier.
* **Invoice Inbox** - The email address used for receiving supplier invoices.
* **Supplier Groups** - The groups the supplier has been assigned to.
* **Minimum Spend** - The minimum order value required by the supplier.
* **Orders** - The total number of orders you have placed with the supplier.
* **Total Spend** - The total amount you have spent with the supplier.
* **Last Order Date** - The date of your most recent order with the supplier.

{% hint style="info" %}
**Invoice Inbox**

This field is automatically generated for each supplier to send their invoices, allowing them to be matched with received goods. It’s especially useful when using the **Expense** module. Simply share this email address with each supplier so they can email invoices, in PDF format, directly to your unique **Invoice Inbox**.&#x20;
{% endhint %}

***

### Options for Managing the Supplier

Click the 3 dots in the top right to open a menu containing the available options for managing the supplier.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FlhHZdBFZUwf1bN0j72Tm%2F2%20-%20Supplier%203%20Dot%20Menu.png?alt=media&amp;token=bffefc1a-5e59-46a7-a6e3-cecf70f2edeb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This menu is available across all tabs on the supplier’s page and provides the same supplier management options regardless of which tab you are viewing.
{% endhint %}

***

#### Edit Supplier

Opens the **Edit Supplier** form allowing you to edit the supplier's details.&#x20;

{% hint style="success" %}
👉 See [#editing-a-supplier](#editing-a-supplier "mention") below for more details.
{% endhint %}

***

#### Smart Purchase

Opens the **Smart Purchase Order** form, where you can create a new **Smart Purchase Order** for the supplier.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F0ZToVodfGa89EIXfLeFb%2F2%20-%20Smart%20Purchase%20Order%20Form.png?alt=media&amp;token=02f0e797-6ade-43f7-9f38-f5c2cdc3486d" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
👉 See the [Smart Purchase Orders](https://help.supplyd.co/supplyd-erp/purchases/smart-purchase-orders.md) document for details on how to complete this.
{% endhint %}

***

### Actions&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fnkxdn6qHjTCqLS5Q9eAR%2FSupplier%203%20Dot%20Menu%20-%20Actions.png?alt=media&amp;token=4d656881-4fbe-43f8-b960-ed99d2d93769" alt="" width="281"><figcaption></figcaption></figure>

***

#### Set Next Call Date

Opens the **Set Next Call Date** form, allowing you to schedule the next call with this supplier and record the planned date in the system.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fap2SC7WDsivYS11FBXMn%2F4%20-%20Set%20Next%20Call%20Date%20Form.png?alt=media&amp;token=6487bfea-d40e-419f-8a9d-121671c994d1" alt="" width="563"><figcaption></figcaption></figure>

**Supplier**

Automatically entered.

**Location**

Select the location for the call.

**Next Call Date\* \[required field]**

Select the date from the calendar that appears when you click this field.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FYVb3ZG6IeaklB1DTEAr6%2FNext%20Call%20Date%20Calendar.png?alt=media&amp;token=a2e81684-943c-48b8-90ff-e158632b2bcf" alt="" width="375"><figcaption></figcaption></figure>

***

#### Merge Supplier

**Merge Supplier** allows you to consolidate <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F8B1C3zJDYw7ImFTX0Km9%2FCUSTOM.png?alt=media&amp;token=05d3ab51-6b48-4c07-906e-d8447a7798c4" alt="" data-size="line"> and <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FFTHs4zC4hhGk6SbI5YDc%2FSUPPLY'D.png?alt=media&amp;token=e59dbd39-c413-47a7-a51f-e8ca7aef4d25" alt="" data-size="line"> suppliers.

If, for instance, a supplier registers with Supply’d and creates a duplicate supplier record in your list, you can use the **Merge Supplier** option to combine your existing Custom supplier record with their Supply’d account.

{% hint style="info" %}
&#x20;Before merging, there are a few things to keep in mind:

* **Merging is safe to do at any time.** Even if the supplier has not yet loaded their full product catalogue, merging will not remove or overwrite your existing products, pricing, or sizes for that supplier. If the supplier has not loaded their products, the **Suppliers > Products** tab may appear empty after the merge. This is expected. Any custom-created products will remain available under **Favourites**.
* **Purchase Orders will continue to work as normal.** If the supplier has not yet linked their products, those items will appear as unassigned on the supplier’s end until they are matched.
* **Check your product barcodes to avoid duplicates.** Before adding the supplier’s catalogue to **Favourites**, make sure your products have the correct barcodes. Matching barcodes allow Supply’d to automatically link products. If the barcodes do not match, duplicate products may be created and require manual cleanup.
* **Match products in bulk.** If you have a large number of products to match, you can update them in bulk using a CSV spreadsheet, rather than matching products individually.\
  👉 See [Bulk Importing of Products](https://help.supplyd.co/supplyd-erp/products/bulk-importing-of-products.md).<br>
  {% endhint %}

***

#### Get Invite Link

The **Supplier Invite Link** allows you to invite a supplier to join Supply’d and connect with your business. Share the link with the supplier so they can register for a free **Supply’d HUB** account and connect with you.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F0pWsZfMtsVbK3abXhKcc%2FSupplier%20Invite%20Link.png?alt=media&amp;token=6078e8eb-80f4-454b-b53f-1dfe4825292f" alt="" width="563"><figcaption></figcaption></figure>

***

### Import&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FIXgcEU22ZDZyb24ou1VV%2FThree%20Dots%20-%20Import.png?alt=media&amp;token=f6e28571-d83b-4940-884b-60c79ac7b5d6" alt="" width="188"><figcaption></figcaption></figure>

{% hint style="warning" %}
The **Import** option is only available for **Custom Suppliers**.
{% endhint %}

***

#### Products

Opens the **Import Products** form, where you can bulk import products from the supplier into Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F2QfxnbPA25T43CP4cwu7%2FImport%20Products%20Form.png?alt=media&amp;token=b7542250-cbca-4ae9-82b8-ab746a31e025" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
👉 See the [Adding Products in Bulk](https://help.supplyd.co/supplyd-erp/products/bulk-importing-of-products/adding-products-in-bulk.md) document for full detail on how to do this.
{% endhint %}

***

### Export&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FsgGNrAK6kM7xDYthPjK7%2FThree%20Dots%20-%20Export.png?alt=media&amp;token=bef40f30-975e-4758-b3c6-3aa2b873ca91" alt="" width="188"><figcaption></figcaption></figure>

***

#### Products

Opens the **Export Products** form, allowing you to download a list of the supplier's products and all their details.

{% hint style="warning" %}
This option is only available for **Custom Suppliers**.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FiQg0uKuXBAX8PM3plNKR%2FExport%20Products%20Form%201.png?alt=media&amp;token=ec6b0b02-c7a6-4673-b3e4-6cc590033743" alt="" width="563"><figcaption></figcaption></figure>

Select the fields you would like to include information for and click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fk4dNldeF9sa3RlM8n4dQ%2FEXPORT.png?alt=media&amp;token=1ebf56ac-e755-43ba-a60d-8d996ec3de7c" alt="" data-size="line">.

<figure><img src="https://help.supplyd.co/~gitbook/image?url=https%3A%2F%2F2965503026-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDaPYJDB89ny0x7wcMedb%252Fuploads%252F6bXIiYxeaIlr9FzSop67%252FProduct%2520Details%2520Spreadsheet.png%3Falt%3Dmedia%26token%3Dc0e084cd-a886-49bf-a77e-050d9c1c0d22&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=bf1e38d3&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

#### Call Logs

Opens the **Export Call Logs** form, where you can download a list of all calls made to and received from the supplier.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FTVjTUWimlZIrVfaX4YTY%2FExport%20Call%20Logs%20Form.png?alt=media&amp;token=de7cd089-801f-4231-a437-f6b4607ddf5f" alt="" width="563"><figcaption></figcaption></figure>

**Supplier**

Automatically entered.

**Locations**

Select **All** to download information across all your locations, or choose a specific location.

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fk4dNldeF9sa3RlM8n4dQ%2FEXPORT.png?alt=media&amp;token=1ebf56ac-e755-43ba-a60d-8d996ec3de7c" alt="" data-size="line"> to download the information as a spreadsheet.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FoxNhhGO5bdNczYYHioxO%2FCall%20Log%20Download.png?alt=media&amp;token=9e65e131-c2d8-4cf8-b725-711520f05501" alt=""><figcaption></figcaption></figure>

***

#### Remove Supplier

This will remove the supplier.&#x20;

{% hint style="success" %}
👉 See [#removing-a-supplier](#removing-a-supplier "mention") below.
{% endhint %}

***

### Editing a Supplier

{% hint style="warning" %}
You can only fully edit suppliers you have added to your Supply'd account. These suppliers are marked with a <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F8B1C3zJDYw7ImFTX0Km9%2FCUSTOM.png?alt=media&amp;token=05d3ab51-6b48-4c07-906e-d8447a7798c4" alt="" data-size="line"> status, making them easy to identify.&#x20;

**Supply’d Suppliers** have limited editing options, as most of their information is managed by the supplier. These suppliers have the <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FFTHs4zC4hhGk6SbI5YDc%2FSUPPLY'D.png?alt=media&amp;token=e59dbd39-c413-47a7-a51f-e8ca7aef4d25" alt="" data-size="line"> status.
{% endhint %}

{% stepper %}
{% step %}
Select **Suppliers** from the main menu to open the **Suppliers** page, then select the supplier you would like to edit.

The supplier’s **Profile** page will open.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FcBqct0qCOkJWm1dQdTHw%2F3%20-%20Supplier%20About%20Tab.png?alt=media&amp;token=e634ab7c-c35f-4a54-886b-184f7df10502" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Click on the 3 dots in the top right and select **Edit Supplier**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmBsHwmehFSqnwXlRVGEP%2FEdit%20Supplier.png?alt=media&amp;token=3adb6c95-b6f8-43ee-9add-f042c2f3e2bf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

The **Edit Supplier** form will open.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FEutOW3rc05gB5P13Y6QU%2FEdit%20Supplier%20Form.png?alt=media&amp;token=cbc8e868-4a8b-49d4-b3cf-99dbdbe2461c" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Update any details as needed, following the guidelines for [Adding a Custom Supplier](https://help.supplyd.co/supplyd-erp/suppliers/adding-suppliers/adding-a-custom-supplier.md) .

{% endstep %}

{% step %}
Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fw7vNdWre4ViL4czC3qLv%2FSAVE.png?alt=media&amp;token=96a25e18-5d77-4c97-82c6-d9d9d6362740" alt="" data-size="line"> to update the supplier's details.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

### Removing a Supplier

{% stepper %}
{% step %}
Select **Suppliers** from the main menu and choose the supplier you would like to remove.

{% endstep %}

{% step %}
Click on the 3 dots in the top right and select **Remove Supplier**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FHVhcayd905GDwJGGO4Ow%2F5%20-%20Remove%20Supplier.png?alt=media&amp;token=a826caaf-1fe7-43dd-8bf1-a1ca129ffb21" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F1i0WSuta2vKqUKuP5heh%2FSpacer.png?alt=media&amp;token=5489e18e-49ae-4046-946e-009eff125495" alt=""><figcaption></figcaption></figure>

You will be asked to confirm.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Confirm that you really do want to remove the supplier as the supplier will be removed along with all of their products.&#x20;
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F1i0WSuta2vKqUKuP5heh%2FSpacer.png?alt=media&amp;token=5489e18e-49ae-4046-946e-009eff125495" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FgmGtKiHQPapAUEtYCImm%2F5%20-%20Confirm%20Remove%20Supplier.png?alt=media&amp;token=bfae8acc-e23e-49f5-9c12-a921eff15ae3" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

Click <img src="broken://files/tVCRFyb7eYQZ3etIMUVb" alt="" data-size="line">.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FDUmgNfSfK97OiojE6o8j%2FSpacer.png?alt=media&amp;token=e0983771-a03e-4524-ad74-a5de34340257" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.supplyd.co/supplyd-erp/suppliers/managing-suppliers/managing-an-individual-supplier.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
