Title

Icon

Card

Main

Light

Accent

For more details about Master Data data entities, see the data entity article.

1. In the VTEX Admin, go to Store Settings > Storefront > Master Data.
2. In Master Data, click Applications > Advanced Settings > Data structure.
3. Click the Data Entities tab.
4. Click Add new.
5. Complete the fields of the Data Entity section with the following information:

   Field name	Value
   Acronym	NL
   Name	Newsletter
   Primary key type	Generate a unique GUID

6. In the Fields tab, create three new fields:
   Field 1

   This field will store the customer's email address for newsletter subscription.

   1. Click New Field and complete the fields with the following values:

      Name	Display Name	Type
      email	Email	Email

   2. Click the gear icon (⚙️) to open the field configuration options and check all the following options:
      • Is nullable?
      • Make readable without credentials
      • Allow editing without credentials
      • Allow filtering without credentials
   3. In the Search and filter settings section, check the Is searchable? and Is filterable? options.

   
   Field 2

   This field will indicate whether the user will receive the newsletter.

   1. Click New field and complete the fields with the following values:

   Name	Display Name	Type
   isNewsletterOptIn	Receive newsletter?	Boolean

   2. Click the gear icon ⚙️ to open the field configuration options and check all the following options:

   • Make readable without credentials
   • Allow editing without credentials
   • Allow filtering without credentials

   3. In the Search and filter settings section, check the Is searchable? and Is filterable? options.

   
   Field 3

   This field will store the user’s name.

   1. Click New Field and complete the fields with the following values:

      Name	Display Name	Type
      name	Name	Varchar 750

   2. Click the gear icon (⚙️) to open the field configuration options and check all the following options:
      • Make readable without credentials
      • Allow editing without credentials
      • Allow filtering without credentials
   3. In the Search and filter settings section, check the Is searchable? and Is filterable? options.

   
7. Click Save and you will be redirected back to the Data Entity tab.
8. In the row of the new NL entity, click the diskette 💾 to publish the created data entity.
9. Click OK.
10. Click the Applications tab to return to the Master Data homepage.
11. Click Reload applications.

The field information must be the same as described in Creating via Admin.