Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Employee attribute template is a planning tool Viva Glint Administrators use to document an organization’s file format and attribute selections, before uploading employee data to the Microsoft Viva Glint platform. Use the template to document decisions that you and other data stakeholders make as you meet and prepare to upload employee data.
Why use the Employee attribute template?
Every report, recommendation, and action plan that Viva Glint presents for your organization relies on the foundation of employee data that you provide. The collection of detailed information about the people in your organization is essential to highlight meaningful insights from survey results and determine what you're doing right and where your opportunities lie.
Fill in the template
The first tab of the attribute template contains instructions for documenting information in the file and Viva Glint data requirements. Follow the guidance on the instruction page and in the terminology table to structure your data and make data decisions.
Viva Glint supports employee data imports in .csv and .xlsx formats:
- .csv files must be comma-delimited and can use UTF-8 or UTF-8 with BOM encoding.
- .xlsx files must contain a single worksheet.
- Viva Glint People Import and SFTP support both .csv and .xlsx files.
- Organizational data in Microsoft 365 supports UTF-8 or UTF-8 with BOM encoding for supported import and connector scenarios.
Employee attribute template terminology
| Term | Definition |
|---|---|
| Employee attribute template | Guidance in the form of a downloadable workbook for documenting your organization’s file format and data selections, before setting up attributes in Viva Glint. |
| Attributes | Demographic details about employees that become report filters in the platform. |
| Attribute Header Row | The blueprint for columns of data and the labels for the columns. |
| Required Attribute | Information about each employee in your organization that Viva Glint requires:
|
| Custom Attribute | Any employee information collected in addition to required attributes. Your organization can send up to 100 custom attributes. Examples: gender, work location, department. |
| Flat Attribute | A category that can't be broken down further, such as age group or gender. |
| Optional System Attribute | A value that indicates how and when Viva Glint sends communications to an employee, such as language* and time zone. |
| Hierarchy | Filtering down of an employee attribute into levels from highest to lowest, largest to smallest, to provide more precise insights. Example: Region > Country > State > City |
| Derivation | Fields calculated based on employee attributes. Examples: Age groups based on birth year or tenure based on hire date. |
| Schema | The framework in our platform that stores a mapping of your organization’s attributes. |
| Reserved attribute mapping | A mapping step enabling Viva Glint attribute to be updated via attributes from Organizational data in Microsoft 365. |
Important
* See Recent language changes for changes to supported languages and codes effective April 10, 2025.
Next step
After finalizing your attribute selections, reporting hierarchies, and file and date attribute formats, review your employee data with a Viva Glint checklist.