> For the complete documentation index, see [llms.txt](https://docs.b2b-sellers.com/b2b-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2b-sellers.com/b2b-platform/2/user-guide/configuration-of-purchasable-addons/customer-specific-product-numbers.md).

# Customer Specific Product Numbers

Customer-specific product numbers allow you to link your own product number to the shop's product number. Once defined, you will be able to search for both the number present in your shop as well as your ERP's article number.

## Initial setup

### How to enable the addon

If you are on the Unlimited plan or have purchased the addon, you will be able to configure this addon. 

Under B2B settings, select "License settings". Scroll down until you find the customer-specific product numbers.

<figure><img src="/files/Nm8hcgJ48tqk2TdxMtnU" alt=""><figcaption></figcaption></figure>

### How to configure the addon

Once enabled, a new item will appear in the sidebar with all B2B settings, where you previously found the license settings.&#x20;

<figure><img src="/files/baAB0XCC4YWHushVfOYq" alt=""><figcaption></figcaption></figure>

Click the item to open up the next screen:

<figure><img src="/files/mKk3SB9Kbn8oytzbuQZ9" alt=""><figcaption></figcaption></figure>

#### Change how the custom product number is being displayed

Under "Display of the customer-specific product number", you can choose between 3 options.

* not displayed
  * The custom number will not be displayed inside the shop.&#x20;
* display additional
  * Both the custom number and the original shop number will be displayed, the custom one is shown as second number.
* replacing the standard shopware product number
  * The custom number will take the place of the previous number and be the only visible number shown to customers.

#### Change behaviour if no custom product number exists yet

Under "presentation on the product detail page if no customer-specific number has been created?" you can choose between X options:

* do not display hint
  * No additional items or boxes will be shown.
* Link to the B2B platform
  * A link will appear that leads you to the product number list.

    <figure><img src="/files/ODPUF6GWLzjpMR7f5BSw" alt=""><figcaption></figcaption></figure>
* create customer product number form
  * A textbox will be shown below the existing number, allowing you to directly add your own on the fly without having to leave the page first.

    <figure><img src="/files/esUsnwrynrOMDkPiP4st" alt=""><figcaption></figcaption></figure>

## How to configure product numbers

You can access all existing customer-specific product numbers by opening the list view that you can access by clicking "Company" > "My product numbers" in the customer portal menu.

<figure><img src="/files/2cmK7ZSZ7g4owqS2P5Ll" alt=""><figcaption></figcaption></figure>

This page allows you both to view all existing connections, edit existing connections, as well as add new connections.&#x20;

<figure><img src="/files/8ULpxVh4hXXF99Na2415" alt=""><figcaption><p>A look at the product numbers list view</p></figcaption></figure>

### Add new product numbers

#### From the list view

Click the button "Create new product number".&#x20;

<figure><img src="/files/weJroxXto9zW9s9dlzOa" alt=""><figcaption></figcaption></figure>

Inside the new modal, add the shop product number first, and in the second field, add your product number. Click "Create" to confirm & add the connection.

<figure><img src="/files/JzzOadR3rexAsp01wno4" alt=""><figcaption></figcaption></figure>

Your product number has been connected! :tada:

<figure><img src="/files/4ksOvztZDCTki9Q3MokK" alt=""><figcaption></figcaption></figure>

#### From the PDP

Depending on your settings for the addon, you will be able to either find a link to the list view or a text input field, allowing you to directly connect a custom product number with the product you're currently viewing.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td></td><td><img src="/files/yjEQTGYPb9klsuLGLZ74" alt="" data-size="original"></td><td></td></tr><tr><td></td><td></td><td><img src="/files/P8HiED4GkH3MhPoAqFe4" alt="" data-size="original"></td></tr></tbody></table>

### Edit existing product numbers

#### From the list view

Click on the green icon on the row that lists your product. A modal will appear, just like the one you get if you create a new link.

Adjust your values and click "Update" to apply changes.&#x20;

<figure><img src="/files/4mZr10zyrrSLjbzOuWee" alt=""><figcaption></figcaption></figure>

#### From the PDP

<figure><img src="/files/E5U10lETq1PplGN6DsED" alt=""><figcaption></figcaption></figure>

Next to your custom product number you will find an icon. If you click this, you will be directed to the list view where you can edit your entry as described one section earlier.

### Delete existing product numbers

#### From the list view

Click on the red icon on the row that lists your product.&#x20;

<figure><img src="/files/22BNvXbZba4nfiaFosaN" alt=""><figcaption></figcaption></figure>

You will be asked to confirm your choice. If you want to delete multiple entries, you can check "Do not ask again", which will prevent this modal from appearing for 24 hours.

<figure><img src="/files/jsFU2FzWb0b5TBZ2nuvq" alt=""><figcaption></figcaption></figure>

#### From the PDP

It is currently not possible to delete product numbers while from the PDP view.

## Find products faster via search

In all types of search forms available across our B2B platform, and the integrated Shopware search, you will be able to search for your custom product numbers with ease.

<figure><img src="/files/wgvKJMhB9e8xvzE7uHRm" alt=""><figcaption><p>Find custom product numbers in Fast order.</p></figcaption></figure>

## FAQ

* My shop already uses the product number "12345", but I want to add my custom product number "12345" as well for a product. Is this possible?
  * Yes, this is possible. Both values are connected, but do not overwrite each other.
* If I search for "12345", will I be able to find both products associated with the number?
  * No, the custom product number takes precedence in search over the shop's article number.&#x20;
* Is it possible to accidentally use the same custom product number twice?
  * No, you will receive an error message, preventing you from doing that. ![](/files/2s7chVZrysqiIsv7XJek)


---

# 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.b2b-sellers.com/b2b-platform/2/user-guide/configuration-of-purchasable-addons/customer-specific-product-numbers.md?ask=<question>&goal=<endgoal>
```

`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.