How to configure tradeName to use in the organization search field

B2B Suite

B2B Organizations

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-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-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-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-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-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-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-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-Suite/settings/masterdata7.png"}}