How to configure tradeName to use in the organization search field (B2B Suite)

Learn how to configure the tradeName field as filterable in Master Data to enable searching and filtering organizations by trade name in the VTEX Admin.

1 min read

This documentation applies to B2B Suite only.

The tradeName field is used to identify buyer and supplier companies on the platform. When configured as Filterable, the field allows users to filter data and search for companies based on their trade name. The tradeName is displayed as one of the identification attributes on the Organizations page in the VTEX Admin, enabling its use in record search and filtering.

To configure the tradeName field, follow the steps below:

In VTEX Admin, go to Store Settings > Storefront > Master Data.

{"base64":" ","img":{"width":1852,"height":959,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":117893,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata1.png"}}

After logging in, click Advanced settings as shown in the image below.

{"base64":" ","img":{"width":1585,"height":962,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":36630,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata2.png"}}

In the Settings column, click on Data structure.

{"base64":" ","img":{"width":1521,"height":958,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":33193,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata3.png"}}

Click Data Entities, find the CL row, and click the Edit button as shown in the image below.

{"base64":" ","img":{"width":1534,"height":932,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":27407,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata4a.png"}}

{"base64":" ","img":{"width":1549,"height":680,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":154126,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata4b.png"}}

Find the tradeName field and click Is filterable.

{"base64":" ","img":{"width":1639,"height":1978,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":199119,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata5.png"}}

Click Save.

{"base64":" ","img":{"width":337,"height":169,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":6270,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata6.png"}}

Click the Publish button to apply the changes

{"base64":" ","img":{"width":1366,"height":621,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":155574,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/b2b/b2b-suite/settings/masterdata7.png"}}