# Developers

PeopleGoal is a REST API for interacting with your personal PeopleGoal account. Every request made to the API is made with a personal token tied to your user account on [PeopleGoal](https://www.peoplegoal.com/product).

PeopleGoal supports the use of the OAuth2 authentication strategy on our Enterprise plan. We support generating and building applications on the PeopleGoal API. Each application will return a *'client_secret'* and *'client_id'* value pair which can be used with the *'client_credentials'*, authorization and token/refresh token strategies. For more details on this please contact your account manager.

[You can access our API documentation for developers here](https://developers.peoplegoal.com/docs).

Developer documentation for building on PeopleGoal's open API

Developers

# Connect BambooHR To PeopleGoal

PeopleGoal integrates with BambooHR, allowing you to utilize your BambooHR account employee database in your PeopleGoal account. BambooHR can be the primary source of employee information and it automatically syncronizes with PeopleGoal. 

In this article, we provide a step-by-step guide on how to connect your BambooHR account with your PeopleGoal account.

## Step 1: Generate an API Key in your BambooHR Account

The API key allows you to connect your PeopleGoal account to BambooHR. In BambooHR, click Account > API Keys and 'Add a New Key'. Once you generate your API key make sure you make a copy of it.

![How to Generate a BambooHR API Key](//images.ctfassets.net/6g4s9n00xmsl/5TwThlm0YBv3pE09FLVyRe/ae8ca287b74e18f9c9509f3706337ffb/BambooHR_Api_key.gif)

## Step 2: Add your BambooHR API Key in your PeopleGoal Account

In PeopleGoal, under Settings and Integrations, go to BambooHR and click 'Add an API Key'. Paste the text into the 'API key' field. Then, add your BambooHR account name as it appears in your subdomain, i.e. peoplegoal for https://peoplegoal.bamboohr.com.

![BambooHR to PeopleGoal](//images.ctfassets.net/6g4s9n00xmsl/1lkVs28gMdviW9ElnyVa3V/c54c38b99a9fec43ca12ec8b81af512c/BambooHR_to_PeopleGoal.gif)

## Step 3: Syncronize your BambooHR account with PeopleGoal

The syncronization imports all your employees, managers, teams and profile pictures from BambooHR to your PeopleGoal account. Once you click on 'Run Synchronization', your status will update to 'In progress'. 

The process can take a few minutes, so you can leave it running in the background. The syncronization step will run automatically daily after the first run.

![BambooHR to PeopleGoal sync](//images.ctfassets.net/6g4s9n00xmsl/1kMYWnB6xd9gYnowgL6Hcd/9173e21ee34188d941b604df7b1af033/BambooHR_to_PeopleGoal_sync.gif)

Once you complete the integration set-up, Bamboo HR will be your primary source of employee information in PeopleGoal. Any employee changes that take place in BambooHR will be reflected in PeopleGoal through the overnight sync.

## Custom employee profiles with BambooHR data
As part of our enterprise plan we also offer an employee profile integration. The employee profile integration with BambooHR allows you to connect your PeopleGoal Account with the BambooHR employee information tables. These include:

- Employee Information
- Employeent Status
- Compensation & Benefits
- Contacts and Emergency Contacts 
By enabling the employee profiles integration your can enrich your [PeopleGoal](https://www.peoplegoal.com/product) employee profiles with data such as:
- Employee Number
- Hire Date
- Salary
- Pay Group
- Pay Type
- Address and more

A full list of all the availiable BambooHR fields can be accessed [here](https://documentation.bamboohr.com/docs/list-of-field-names).

If you would like to implement the employee profile integration please reach out to us at contact@peoplegoal.com.


In this article, we will provide a simple to follow guide on how to connect your BambooHR account with your PeopleGoal account.

An easy to follow guide on how to connect PeopleGoal with your BambooHR account

Connect BambooHR To PeopleGoal

# Integrations

Connect your data in a few easy steps. Whether it's bringing in the employee database from BambooHR or sending out item updates from your PeopleGoal apps to Slack, PeopleGoal talks to your other systems.

## HRIS & Employee Database Integrations

- [Connect BambooHR To PeopleGoal](https://www.peoplegoal.com/support/article/bamboohr-peoplegoal-integration)
- [Connect Microsoft Azure Active Directory to PeopleGoal](https://www.peoplegoal.com/support/article/peoplegoal-microsoft-azure-active-directory)
- [PeopleGoal integration with ADP Workforce Now](https://www.peoplegoal.com/support/article/peoplegoal-adp-workforce-now "PeopleGoal integration with ADP Workforce Now")

## Communication Tools Integrations

- [PeopleGoal integration with Microsoft Teams](https://www.peoplegoal.com/support/article/microsoft-teams-peoplegoal-bot)
- [PeopleGoal integration with Slack](https://www.peoplegoal.com/support/article/peoplegoal-slack-application)

## Reporting Integrations

- [Connect PeopleGoal to Microsoft Power BI](https://www.peoplegoal.com/support/article/connect-peoplegoal-to-microsoft-power-bi)

## API Documentation

- [PeopleGoal API Documentation](https://developers.peoplegoal.com/docs)


Connect your data through PeopleGoal integrations with Slack, Zapier, BambooHR, Workday and more

Integrations

Connect your data through PeopleGoal integrations with Slack, MS Teams and more

# PeopleGoal integration with Microsoft Azure Active Directory

PeopleGoal integrates with MS Azure Active Directory to enable our customers to import employee information into their PeopleGoal account through an automated process. Employee data stored in Microsoft Active Directory will act as the primary source of users and profile data for PeopleGoal. 

Configuring your integration is a simple, step-by-step process that we've outlined below. 

## Step 1: Navigate to Azure Active Directory and create a new application.

In your Azure portal select __app registration__ and __create a new app__. Give a name to your app and select one of the two multitenant options as shown below.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/5qTVdNKKcxUGCRzRKX615C/d2d2ead62f040b2b6e37de95146fc149/PeopleGoal_Azure_Step_1.mp4"></source>
        </video>

## Step 2: Enable API permissions to read data.

In your new app page navigate to API permissions and click on __add a permission__. Then proceed to set permisions as shown below:

![PeopleGoal Azure Step 2 Permissions Image v1](//images.ctfassets.net/6g4s9n00xmsl/3cwydmdxVjm3JL650jgO1a/f7cde69b0c62c7e3cde11f0985428d07/PeopleGoal_Azure_Step_2_Permissions_Image_v1.png)

Once you set up the permisions you will also have to grant admin consent by clicking on the option above the permissions.

## Step 3: Create a Client Secret

Create a key which will be used as the Client Secret in the PeopleGoal connection. Click on __certificates and secrets__ in the menu and __new client secret__. Make sure you make a copy of the secret, not the ID, and __save it__ as you will not be able to retrieve it again.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/6qAyKy6ZTJ6v1iUaqfl3Dt/50c31ff53a92f32af6a075b7c135e4d1/PeopleGoal_Azure_Step_3.mp4"></source>
        </video>

## Step 4: Set up your Application ID URI

Navigate back to the overview and click on the __Application ID URI__. This will generate a URL which you will add into PeopleGoal later on.

![PeopleGoal Azure Step 4 URI v1](//images.ctfassets.net/6g4s9n00xmsl/1FEvfVUzU7nloQgDVC2uuN/312274a3601f0dffdfce39a531083406/PeopleGoal_Azure_Step_4_URI_v1.png)

And that is the end of the MS Azure application set up.

## Step 5: Enable the MS Azure Active Directory Integration in PeopleGoal

In your [PeopleGoal](https://www.peoplegoal.com/product) account navigate to __Settings__ and then __Integrations__ and click on __Azure integration__. You will be promted to add the following details:

- Client ID (required)
- Client Secret (required)
- Client URI (required)
- Client Tenant (required)

This information is availiable in your MS Azure account (see steps 1 to 4 for reference). I hope that you have saved your secret id otherwise you will have to generate another one.

![Connect MS Azure AD to PeopleGoal ](//images.ctfassets.net/6g4s9n00xmsl/1xZEHJjVvWZA9wvUeRWVcj/c1b206109160b7cc15091e00d5dbcf50/Step_5_Connect_to_PeopleGoal.png)

## Step 6: Run the integration for the first time

Once you have completed step 5 you are all set to run the integration for the first time by clicking __Run now__. If you tranferred the required information correctly the integration will start importing users, profiles, manager and team data. The first sync depending on size of your organization might take some time to complete. You will be able to see a quick summary of the sync data by clicking on of statuses in the Sync history area. The syncronization details cover users, teams and errors.

![Step 6 Run first sync MS Azure AD to PeopleGoal](//images.ctfassets.net/6g4s9n00xmsl/Q8HhBgmfYen17bdNoZejV/a60241c74973fa416c5d0edd17afbe52/Step_6_Run_first_sync_MS_Azure_AD_to_PeopleGoal.png)

Microsoft Azure Active Directory (AD) will be the primary source of users. Every night at midnight PeopleGoal will pull your active directory users and sync profiles on PeopleGoal. New users will be ready to invite to PeopleGoal.

If you run in to any errors our Customer Support team can run troubleshooting with you. Reach out to us on contact@peoplegoal.com and we'll get you on the right track.

We are excited to announce that PeopleGoal now integrates with Microsoft Azure Active Directory. Connecting PeopleGoal to your Microsoft Azure Active Directory account means that you can import all users and user profiles from your Active Directory account.

The PeopleGoal MS Azure Active Directory integration allows you to send all employee information to PeopleGoal automatically.

PeopleGoal integration with Microsoft Azure Active Directory

Connect PeopleGoal to your Microsoft Active Directory

# How to Set Up 360° Feedback

__360° feedback gives employees a broad picture of their skills, working style and team relationships. It encourages open and honest communication between staff and ensures that performance conversations don't happen with just a supervisor. 360° feedback should be gathered for an individual from many different levels of the organization: from juniors, colleagues, supervisors and leadership. Recipients are able to see who provided the feedback to promote transparency, accountability and fairness in the process.__

[PeopleGoal](https://www.peoplegoal.com/product) translates this multi-step process to a seamless workflow in our 360° Feedback app. The app template is ready to go if you're looking for a quick implementation, or you can easily customize the process using our simple, no-code workflow builder. It is a completely flexible process, with both the employee and the manager being able to kick off the feedback request.

Following the steps below, install and launch 360° feedback in a few minutes:

1. <a href="#install-360-feedback-app">Install the 360° Feedback app template</a>

2. <a href="#customize-360-app">Customize the 360° Feedback app template (optional)</a>

3. <a href="#configure-360-app">Configure the 360° Feedback app states (optional)</a>

4. <a href="#manage-360-app-participants">Manage your app participants</a>

5. <a href="#set-360-app-permissions">Set up access permissions</a>

6. <a href="#launch-360-app">Launch 360° Feedback!</a>

Let's get started.

<div id="install-360-feedback-app"></div>

---

## 1. Install the 360° Feedback template from the app store

- Open up any workspace, click __Create a new app__, the select __Store template__.
- Select the 360° Feedback app and click __Add this to your account__.
- Select the workspace (and workspace folder) you want this app to belong to from the drop-down menu, then click __Install template__.

It will take a few seconds to add install the app in your account, and you'll be taken straight to the app to get started.

![360 feedback install template](//images.ctfassets.net/6g4s9n00xmsl/2e8faQuz9OP11XB8aFmivL/386b6d5db29269d8a6f5bc362efc54d8/360_feedback_install_template.gif)

All of the pre-built feedback questions and states are installed and ready to go. You can use the app right out of the box!

We have sections for Stop, Start, Continue feedback; a rated competency section, and general written feedback.

To skip the customization, <a href="manage-360-app-participants">jump to step 4</a> and set up your app participants and permissions.

<div id="customize-360-app"></div>

---

## 2. Customize the 360° Feedback app template

If you wish to customize the template, click the __Template menu__, and then __Edit template__.

![360 feedback edit template](//images.ctfassets.net/6g4s9n00xmsl/3iHWWp3YNDKdIVyTcJHERC/4f2a7b36617d698e39b3402dd4cdbbd2/360_feedback_edit_template.png)

### i. Edit existing elements

Elements are your individual form fields that make up the Feedback process, and each element is completely customizable and can be changed to suit your custom process and company culture.

- To change a field, hover over the right-hand side of the element and click the three dots that appear.
- Select __Edit element__ (your element will have a name like "Text", "Date", "Rich-text area", etc.). The element editor will open up.
- Change any fields you need to and click __Save changes__ to update.

![360 feedback edit element](//images.ctfassets.net/6g4s9n00xmsl/11Rj4Ofnf2EvS8GNIUWVnz/5119f378da9e911ff6024f673b9aa271/360_feedback_edit_element.png)

### ii. Duplicate elements

- Hover over the right-hand side of the element and click the three dots that appear.
- Select __Duplicate element__ and an exact copy will be created below.
- Edit the duplicated element to change your question text.

![360 feedback duplicate element](//images.ctfassets.net/6g4s9n00xmsl/5F2NozsWA3mnWdrHRCyrn2/5da11f3e4f829bf4c699df106ae84c31/360_feedback_duplicate_element.png)

### iii. Reorder elements and sections

Reordering is easy - you just click and drag to change the element or section order.

- Hover over the left-hand side of the element (or section title) and click and drag your element or section to its new location.
- To move an element to a different section, hover over the right-hand side and click the three dots that appear.
- Select __Change section__ and choose the new section you want the element to belong to.

![360 feedback reorder elements](//images.ctfassets.net/6g4s9n00xmsl/5CROREAp5kTAfldYiRURcF/7330820dff938e58a034ffbbf52fd540/360_feedback_reorder_elements.gif)

### iv. Create new elements and sections

At the bottom of each section, click __Add element__ and select the element type you want to insert.

A new element that's useful to add to your first section is a display-only Description or Rich-text area. You can use this to remind employees and managers of the key feedback cycle dates, or give instructions on how to kick off 360° degree feedback. 

- To add a new section, scroll to the very bottom of your template form and click __Add section__.
- Then click and drag your new section to where you want it to sit in the feedback flow.

In the below example, we are going to add a section for manager feedback in addition to the three peer feedback sections. We're going to duplicate the feedback form for Peer 1 so that the feedback questions are consistent across all participants.

![360 feedback duplicate section](//images.ctfassets.net/6g4s9n00xmsl/77EZ7RPKpgSu2WoxtkaaMo/6021cd591bce3cc170c827585ced2331/360_feedback_duplicate_section.gif)

<div id="configure-360-app"></div>

---

## 3. Configure the 360° Feedback app states

States are the steps in your 360° Feedback workflow and each state has its own participant. The "Feedback Requestor" is one state and "Peer 1", "Peer 2" and "Peer 3" are other states. The "Feedback Requestor" is the person who is going to kick off the [360° feedback process](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide); this could either be the employee who is requesting feedback about themselves, or it could be the manager who is requesting feedback about a direct report.

There's no limit to the number of states you can add to your 360° Feedback workflow, allowing you easily create a complex process where different stakeholders can weigh in. You can also control the visibility of sections (and individual elements) in every state, and select whether they are read-only, editable or hidden to the selected state participant.

### i. Add a new state

- Click the __+__ button in your workflow builder to create a new state.
- Enter your state name, define the participant, and choose a status flag.
- Toggle on/off whether sections are visible or editable by default (don't worry - you can override this later if you need to).
- Click and drag your state to reorder your 360° Feedback workflow and you're done!

In the below example, we are going to add another state for "[Manager feedback](https://www.peoplegoal.com/blog/how-to-give-manager-feedback-5-examples)" so that the manager can answer the section we just added. We are going to call this state "Manager feedback" and create a participant called "Manager". Select any status flag for the time being, we will come back to this later.

Next, we are going to switch the toggle off for "All sections and elements are visible by default" as we don't want the manager to see the peer feedback just yet - they'll be able to see this when all feedback is complete. Finally, we want this section to be editable by the manager so we will leave the toggle switched on.

![360 feedback add state](//images.ctfassets.net/6g4s9n00xmsl/5pzzjv7eoYKRkFOGPi3YLi/02ebdb24ddaf87590b1c2e7617c6802b/360_feedback_add_state.gif)

### ii. Remove a state

- To take out a state you won't be using, click the __Template__ tab and select __Configure states__.
- Select the state you want to delete and you'll see the blue highlight bar appear to confirm which state you've selected.
- Click __Delete state__ to remove it completely.

![360 feedback delete state](//images.ctfassets.net/6g4s9n00xmsl/4B5IVo1cxKY6fluJFaXp9k/99af78cc89cb87c837f3dae81e8bb40b/360_feedback_delete_state.png)

### iii. Customize your status flags

Every state has a default status flag that indicates to all participants what stage of the process their item is in. Your 360° Feedback app is set up with default status flags which you can customize.

- In the __Configure states__ menu, click on __Manage status flags__.
- Click a flag title to rename it, and click the color picker to choose a new flag color.
- Click __Create a new status flag__ to add an additional flag.
- Select the state to which you want to assign your flag, choose which flag to give it and click __Save changes__ to update.

Here, we are going to create a new status flag for Manager feedback called "Manager feedback pending".

![360 feedback status flags](//images.ctfassets.net/6g4s9n00xmsl/7j8o28QJIJJ5DLLHQQFlCt/baeb3d97bece17bc7f2aa97a32789b01/360_feedback_status_flags.gif)

It's a good idea to delete any unused status flags so that they don't clutter up your Item filter once your 360° feedback process is underway. If you take out a Peer Feedback state, you should also remove the relevant "Pending" status flag.

<div id="manage-360-app-participants"></div>

---

## 4. Manage your 360° Feedback app participants

Participants are the individuals involved in the 360° feedback app and each state has one participant. The first participant is called the "Feedback Requestor", and kicks off the process by selecting who the feedback is about. The process is flexible, with both employees and managers able to kick off the feedback request about themselves, a colleague or direct report. The "Feedback Requestor" must also select which three peers are going to give the feedback when they kick off the process in the first state.

### i. Define the default participants

- Select __Template__ from the top menu, then __Configure states__.
- Click __Manage participants__. This will bring up a list of everyone involved in this feedback workflow.
- Select the __Default relationship__ drop-down for the Manager participant, and select the relevant relationship (you might call this supervisor, team lead, etc.).

This means that the manager participant will be automatically populated for a new employee feedback request. The peers will still need to be selected individually.

![360 feedback add participant](//images.ctfassets.net/6g4s9n00xmsl/76YpXk8ejkXiPYonSQzrNT/dcc959756110c556a5be73c2bc26a902/360_feedback_add_participant.png)

### ii. Define the participant's visbility

Visibility defines whether a participant can see the feedback only in the state that they own (limited visibility), or in all states (full visibility).

We want the "Feedback Requestor" to have full visibility so that they are able to see the feedback they are given. The "Peers" however, should only have limited visibility because we only want them to see the feedback that they give. 

However, if you want to change a visibility level:

- Select Template from the top menu, and click Configure states.
- Click Manage participants.
- Click the drop-down next to the participants name and choose __Limited__ or __Full visibility__.
- Click __Save changes__ to lock in your updates.

![360 feedback visibility](//images.ctfassets.net/6g4s9n00xmsl/5taGf9VOHmkBKroJ7WOLrZ/5373d5aa91744a5829b1dba7df9c132b/360_feedback_visibility.png)

<div id="set-360-app-permissions"></div>

---

## 5. Set the 360° Feedback app Permissions

Nearly ready to launch! The last step in automating the Feedback workflow is to decide who can create, edit and/or view all the 360° Feedback in your account. To do this, we use Permissions.

Permissions control the access to your app within your PeopleGoal account.

- To set your permissions, click on the __Settings__ menu, then expand the __Permissions__ section.
- Click on __Explain permission types__ to understand the access that each permission gives your account users.

![360 feedback explain permissions](//images.ctfassets.net/6g4s9n00xmsl/32afU4F9wkDlFDwNqp0vcZ/408ef4a8945561dc98c758b4cdd28b02/360_feedback_explain_permissions.png)

### i. App-wide permissions

For 360° Feedback we'd recommend you set the permission to __Create only__. This means employees can kick off the feedback process for themselves or others, but can't see any colleagues' feedback.

### ii. Specific relationship, team and user permissions

The user who installed the 360° Feedback app template has __Owner__ permission by default, and can assign specific permissions to other teams or users. Specific team and user permissions supersede the default permission type.

- To assign a specific permission, select __Configure specific permissions__, then under "User permissions" click __Add user__.
- Type your colleague's name to add them to the permissions list. In the "Permission type" column, select which permission level to give them.

You might want to give "View only" permission to your C-Suite, so that they can see all 360° Feedback for all employees but not change the app settings or edit states that they're not a participant in.

To give managers access to create feedback requests for their direct reports, you'll set up a sepcific relationship permission.

- Select __Configure specific permissions__
- Under "Relationship permissions", select the Manager relationship (or supervisor, team lead, whichever relationship name you have set up!)
- This will by default give managers the ability to create, view and edit items for their direct reports

![360 feedback relationship permissions](//images.ctfassets.net/6g4s9n00xmsl/G50ItKlLbnvX1wZemFwrg/4b8ee90eeefeea87d86e234f7745509b/360_feedback_relationship_permissions.png)

<div id="launch-360-app"></div>

---

## 6. Launch your 360° Feedback process!

You're ready to roll! All you need to do now is kick off 360° Feedback for your employees. Both employees and managers are able to kick off the process by either naming themselves or a direct report as the person receiving feedback.

- In both cases, click on the __360° Feedback__ menu and click __New 360° Feedback__.
- Select your own name, as you are the first participant (the feedback requestor).
- Insert your own name if the feedback is about you, or insert your direct report's name if it's about a subordinate.

![360 feedback launch](//images.ctfassets.net/6g4s9n00xmsl/1nPbrZ6QBh3igtvMz53EDl/351551cef3e32490eba82a3c41dd18c8/360_feedback_launch.png)

Or, click __Select team(s) of users__ and you can kick off 360° Feedback for entire user groups! But bear in mind you will still need to go into the 360° Feedback report to select the peer reviewers.

### Next steps: set up your custom feedback analytics and reports

We know that every company has its unique ways of working, and the metrics you want to analyze are different to any other organization. We capture every single data point from your 360° Feedback in the Data table, to help you to build custom reports and automated charts. Head over to our [Reports building article](https://www.peoplegoal.com/support/article/reports) to learn how to create custom reports and analytics tracking.

---

Once you've got your 360° Feedback process up and running, take a look at other apps you can install within your Performance workspace. We'd recommend implementing __[regular check-ins](https://www.peoplegoal.com/app-store/template/check-ins-1on1)__ to grow your employee/manager relationships, and __[performance reviews with multiple managers](https://www.peoplegoal.com/app-store/template/reviews-multiple-managers)__ to evaluate employee performance. You'll find all these and more in our __[App Store](https://www.peoplegoal.com/app-store)__.

Don't have a PeopleGoal account yet? __[Book a demo](https://www.peoplegoal.com/book-a-demo)__ to see our no-code [HR workflow](https://www.peoplegoal.com/blog/workflow-examples) builder in action!

Easily set up a custom 360 feedback review using PeopleGoal's feedback app templates

How to set up a 360 feedback review process

# How To ... with PeopleGoal

Being able to configure completely custom workflows opens up a world of possibilities - and challenges! What are the best practices and industry standards for HR processes? How can you adapt these to your own company culture? Our How To's section answers commonly-asked process questions.

- [How to set up an OKRs (Objectives & Key Results) process](https://www.peoplegoal.com/support/article/how-to-set-up-objectives-and-key-results)
- [How to create a 360 feedback app](https://www.peoplegoal.com/support/article/how-to-set-up-360-feedback)
- [How to run employee development plans](https://www.peoplegoal.com/support/article/how-to-run-effective-development-plans)
- [How to run an employee engagement survey](https://www.peoplegoal.com/support/article/how-to-run-an-employee-engagement-survey)
- [How to have a review with multiple managers](https://www.peoplegoal.com/support/article/how-to-run-a-review-with-multiple-managers)

You can also find a How-To guide for all the PeopleGoal apps in the lefthand menu. Or, [browse our App Store](https://www.peoplegoal.com/app-store) to see all of our pre-built HR workflow templates.

Best practices for configuring PeopleGoal apps and building custom workflows

How To's

How to set up 360° Feedback

# Permissions & Visibility

__Permissions are a crucial part of your PeopleGoal platform. Setting up permissions gives you control over who can view, edit and interact with the workspaces, apps and items in your PeopleGoal account. As a workspace or app owner you have the ability to design flexible apps that are relevant for the participants, and using permissions you can easily build your [PeopleGoal](https://www.peoplegoal.com/product) account as an all-in-one HR portal.__

Visibility settings can then be designed on the app template to give further flexibility for state participants, and for the app template itself. We'll explain these concepts below, and show you how to set permissions and visibility across your account.

__You do not need to be an Account Owner to have Owner access on workspaces or apps!__ This is very important and gives a lot of flexibility in your processes. It also gives scope for senior leaders outside of HR to create and run their own initiatives in your PeopleGoal account, without needing access to the Account menu.

---

## Permission types explained

Within workspaces and apps there are six types of permissions that control their visibility:

- __Access denied__: the workspace/app is not accesssible at all.
- __Create only__: users can create items for themselves but can only view the items they participate in. They cannot view items in which they're not a participant. 
- __Create and view__: users can create items for themselves and view all other items in the workspace/app.
- __Create, view and edit__: users can create items for themselves, view all other items in the workspace/app and edit other users' items. They cannot change the workspace/app settings or the app template.
- __Owner__: has full access to all data in the workspace/app and the ability to change workspace/app settings.
- __View only__: can only view all the items in the workspace/app, but cannot create or edit any items or change workspace/app settings.

Using these six permission types, you can control:

- Access to workspaces
- Access to apps (inherited from the workspace, but can be overridden)

---

## Set Workspace Permissions

A __workspace owner__ is the only one who can change workspace permissions. The default owner is always the person who created the workspace (not necessarily the account owner).

- Select __Workspaces__ in the navbar to view all of your workspaces.
- You'll already see a gray permissions flag in the bottom right corner of each workspace tile that shows you the access you have to this workspace.
- Click the workspace you want to open up, then select the __Settings__ tab and expand the __Permissions__ setting.

![peoplegoal workspace permissions](//images.ctfassets.net/6g4s9n00xmsl/57RwyeDp3n3kBtoG038z6X/2c6f3fe6d2821324b7b6db02e9b847d6/peoplegoal_workspace_permissions.png)

### Default permissions

The __default permission type__ is the one that applies to every user in the account. 

- Click the permission type drop-down to change this, then click __Save changes__.

![career development one to one permissions explained](//images.ctfassets.net/6g4s9n00xmsl/7u71Yd0A1nIC5Lrx4gYhh9/75abf9a10610083847a628a5e45ebbc4/career_development_one_to_one_permissions_explained.png)

Typically the default permission type would be "Create only", so that users can access your workspace for themselves but not edit or view any of the other items it contains. But you can also set "Access denied" to create restricted workspaces, and then configure specific permissions to give access to select users only.

### Specific permissions

Now you can grant permissions for exceptional cases. Click __Configure specific permissions__.

Specific permissions can be set for teams of users or for individuals. You'll already see yourself listed in the __User permissions__ area as the workspace owner.

- Click __Add team__ to grant different permissions for every user in a team.
- Then click __Add user__ to grant further permissions for an individual.
- __Even if that individual is a member of the team you selected above, their individual user permission level will override this.__

![career development one to one permissions](//images.ctfassets.net/6g4s9n00xmsl/7zexyz5eFQsBMtLY3MpcLn/5d2261052f2147cef1ee44f0c84e7e7c/career_development_one_to_one_permissions.png)

### Relationship permissions

There are often times when you want to grant access to create, view and edit items for a specific relationship only. For example, you want your Managers to be able to create, view and edit goals for their direct reports only.

- To do this, in the __Relationship permissions__ area click to add the relationship you want to give this special access.
- You can choose any of the relationship types you have created.

### How does this work in practice?

As an example, say we're editing the Performance Management workspace. Your HR team will need to be able to view all data in the workspace but we want to limit the ability for other team members to change the workspace settings. Additionally, your CEO wants to be able to see what's going on in the full organization but doesn't need to create any items for other users.

Our __default permission type__ would be "Create only".
Our __specific team permissions__ would be "Create, view and edit" for just the HR team.
Our __specific user permissions__ would be "View only" for the CEO, and "Owner" for yourself. Even if you're a member of the HR team, it's your user permission that takes precedence and you have "Owner" access rather than just "Create, view and edit".

---

## Set App Permissions

__App permissions are inherited from the workspace the app belongs to__.

When you create a new app all the permissions are exactly the same as its parent workspace. So if you've configured specific permissions for your Performance Management workspace, any app you create in that workspace will also have those same permissions.

However, you can change permissions on the app level to allow different access to your app.

__Note that if you install an app from the App Store, the default permission will be Owner. Remember to update this before you launch your app to all users!__

An example might be that the Talent Development workspace has "Create only" permissions by default, for users to create development plans with their managers and access training apps. Within this workspace you create a Succession Planning app to which you can restrict access for everyone except the HR team.

- To set app permissions, open up the app you want to edit and click the __Settings__ tab.
- Expand the __Permissions__ setting and configure your default and specific permissions the same way you did for workspaces.
- Click __Save changes__ to update.

At the very top of the screen next to your app title you'll see a blue permissions flag, showing you the permission level you have for this app.

![peoplegoal app permissions](//images.ctfassets.net/6g4s9n00xmsl/4sUSaH8RcdviP4Y48Ck5OK/898a1658e09cb28ca90b16bb448e9e8c/peoplegoal_app_permissions.png)

---

## App Visibility

We'll explain this in more detail in the [Apps](https://www.peoplegoal.com/support/article/apps) article, but it's worth going over briefly now.

Apps are workflows that are built as a template that contains __sections__ and __elements__. Apps move through multiple __states__, and each state has one __participant__. __Items__ are an instance of an app created by a user.

Participants are given either limited visibility or full visibility to the item they're participting in. Limited visibility means they can only see the item in the state they own, and full visibility means they can view the item in any state of the workflow.

Sections and elements can be __hidden__ in a certain state, or can be marked __read only__ in a state. This means you can hide whole areas of the workflow from a specific participant, or make those areas read-only to that participant.

![smart goals template permissions visibility](//images.ctfassets.net/6g4s9n00xmsl/6K6W47pKlVA99ITaSs9soT/ffb446e8b5365bafd5bb2f156b3bd6de/smart_goals_template_permissions_visibility.png)

### How does this work in practice?

To illustrate, let's look at the permissions and visibility for a simple Reviews app.

Our review goes through four states:
1. Employee self-assessment
2. Manager assessment
3. HR approval
4. Final confirmation

And we've got three participants:
1. Employee
2. Manager
3. HR reviewer

The __default app permissions__ are "Create only" - employees can create a review for themselves but can't see anyone else's review. Managers can participate in the employee's review but can't see any review in which they're not a participant.

The employee has __limited visibility__ - they can only view the review when they are the state participant. So they can see their self assessment as they draft it, but once it's sent to the manager it becomes inaccessible until it's sent back to the employee for their final signature.

The manager has __full visibility__ - they can view (but not edit) the review when it's in the employee self assessment state and when it's been submitted to HR for approval, even though they aren't the participant in either of these states.

In state 1 the employee self-asssessment __section__ is visible and editable to the employee. The employee is filling out their responses.

In state 2 the employee self-assessment __section__ is __read-only__ to the manager, and the manager assessment __elements__ are editable. The manager is viewing the employee's responses and entering their manager assessment responses.

In state 3 the entire review form is __read-only__ to the HR reviewer, and the HR confirmation __section__ is editable. The HR reviewer can read all the review responses but can only add their comments to the HR confirmation section.

In state 4 the entire review form is __read-only__ to the employee, and the HR confirmation is hidden. The employee can view (but not edit) all of the review responses, and the HR section is kept confidential from the employee.

---

## Quick summary of visibility

So you can see that permissions and visibility give you an extremely flexible level of access control throughout your account. If you're getting stuck, remember that the order in which permissions are given goes:

1. Workspace permissions.
2. App permissions (override any workspace permissions).
3. Participant visibility (whether they can see an item in any state or just the state they own).
4. Section visibility (whether the app section is hidden, read-only or editable to this participant).
5. Element visibility (whether the individual fields within a section are hidden, read-only or editable to this participant).


Permissions control who can view, edit and interact with the workspaces, apps and items in your PeopleGoal account.

Permissions control who can view, edit and interact with the workspaces, apps and items in your PeopleGoal account. This article explains Permissions in detail.

How do PeopleGoal permissions work?

# Become a Pro

Now that you've got the account fundamentals down, learn how to configure your own custom workflows and create new apps. You'll get to understand how state rules, actions and conditions work, and get to know the advanced permission and visibility settings. We'll also take you through the app reporting functionality, how to use the data view to build and schedule custom reports and how to create your own charts.

---

## Key Terminology

These are some of the key terms everybody will come across when using PeopleGoal.

__Apps__ are your processes / workflows - the core functionality of your account. In Performance Management for example, you'll have individual apps for reviews, one-to-one meetings, [360 feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) and OKRs/SMART goals. Or in our Development example below, you see apps for Training Approval, Development Plans and Career Development One-to-Ones. An app has a template for the form you want to complete which is completely customizable.

![peoplegoal apps](//images.ctfassets.net/6g4s9n00xmsl/7Ee2z5nisnprzGNj8yQOBj/1292c265fca411d9a11f3aca9cf14071/peoplegoal_apps.png)

__Items__ are an instance of an app created by a user. The performance review for employee Jane Smith is an item  created in the Reviews app, or your Q1 objectives will be individual items created in the OKRs app.

![peoplegoal items](//images.ctfassets.net/6g4s9n00xmsl/5I91tNEdWD0i0DAqhzYU2n/18961b4e6fa0c584cdb52e18cef19d26/peoplegoal_items.png)

__Workspaces__ are the containers for all of your apps. Think of it as the topic or category for all of the apps within a workspace, like Performance Management or Employee Engagement.

![peoplegoal workspaces](//images.ctfassets.net/6g4s9n00xmsl/sXLowZIwz3KbyjDBgGPPO/d289fe72eb40668274324474da14b0ce/peoplegoal_workspaces.png)

__States__ are stages in the app workflow. Every item can move through many states, with each state's participant being responsible for completing the form in that state and sending it on to the next state.

![peoplegoal states](//images.ctfassets.net/6g4s9n00xmsl/2XzPFjOm0SjP3AVoreDMeW/06804cd5698b1436086ba332503ce57f/peoplegoal_states.png)

__Permissions__ control the visibility of items, apps and workspaces. You'll see permissions like "create only", "create and edit" or "view only". Permissions can be configured right down to the app level, so you can have different workspace and app permissions.

![peoplegoal permissions](//images.ctfassets.net/6g4s9n00xmsl/5RocjpCpDa0b2p1nC413vG/b538458e2ebfcdb8056c3c225cf56d0d/peoplegoal_permissions.png)

__Relationships__ are a link between two users - like Manager/Direct Report, Supervisor/Employee or Mentor/Team Member. You can have many relationships on [PeopleGoal](https://www.peoplegoal.com/product), meaning you're not limited to the traditional employee/line manager views.

![peoplegoal relationships](//images.ctfassets.net/6g4s9n00xmsl/DZra0ByDP4bXIeSLXyEUg/98b94848217018833d4583a0cdaa7ef3/peoplegoal_relationships.png)

__Teams__ are groups of users. You can belong to many teams, and teams can connect to one another to build out a matrix organizational structure that reflects your actual working groups, not just a strict organizational hierarchy.

![peoplegoal teams](//images.ctfassets.net/6g4s9n00xmsl/4GtF0emkKOIz2qk4ktwghd/d041f995e3d324334e9c8c4b3742f192/peoplegoal_teams.png)

Become a PeopleGoal expert with our advanced features and functionality

This section of the PeopleGoal Support Center will go through advanced functionality within our workspaces and apps features, as well as reports scheduling.

PeopleGoal Advanced Features Guide

Become a Pro

Permissions & Visibility

# Display Only Elements

__Display only elements present read-only information that can be used to inform employees as they interact with an app - from instructions as to how employees are expected to fill in their responses, to profile values that can be pulled from the employee profiles.__

The value of incorporating display only elements is their capacity to facilitate easier communication with your workforce. This channel of communication will be presented to employees as they are going through the process of completing a workflow. As a result, this guidance can ensure that employees are executing any process in an accurate and better-informed manner.

There are seven display only elements:

- <a href='#title'>Title</a>
- <a href='#description'>Description</a>
- <a href='#textarea'>Rich textarea</a>
- <a href='#image'>Image</a>
- <a href='#link'>Link</a>
- <a href='#file'>File download</a>
- <a href='#profile'>Profile value</a>

<div id='#title'></div>

---

## Title

The Title element will generate a field for you to present a text block with enlarged text. The text in this element is bigger than any other text you will see in the workflow - consequently, it will stand out from the rest of your instructions.

![display only element title](//images.ctfassets.net/6g4s9n00xmsl/5FiZ399xOSkS3jjCxAxW5w/8dbfc605c76a589d57a69419b1863228/display_only_element_title.png)

Now let's take a look at how it can be applied in your own workflow. 

__Introductory Title__

You may wish to use the Title element at the beginning of each section or for a particular part of a workflow. As the text is clearly set to a larger font than other elements, this may be useful to clearly label the purpose of each section, or the workflow as a whole.

<div id='#description'></div>

---

## Description

The Description element is one of our most commonly used Display only elements. As you might have guessed, this provides a space to present a description for a workflow. This will typically include guidance or information about the workflow or any additional explanations that might be useful for the employee.

![display only element description](//images.ctfassets.net/6g4s9n00xmsl/PsefP2E63V01E2U88gSpu/ffc4cfb967d016f909573e1c04a0f0aa/display_only_element_description.png)

By providing your employees with instructions as to the purpose of this workflow or by giving tips on how they should go about completing them, employees will have further clarity as to how to approach the process. This is especially helpful when they're new to HR software in general. Providing clear, step by step instructions on how to move the item through the workflow sets expectations and makes employees more comfortable with the process. Some examples of this include:

__Development Plan Instructions__

As your employees embark on mapping their paths for [career development](https://www.peoplegoal.com/blog/development-plan), they will likely be very appreciative if you provide them with some pointers. This is where using the description element can be really beneficial.

Simply by adding in some general themes or desirable targets that employees can use to align their development plans, the description element can provide further insights as to how they might approach their responses.

__Onboarding Checklist Information__

When a [new joiner](https://www.peoplegoal.com/app-store/template/new-joiner-survey) is first going through the process of onboarding and checking off that they have completed various activities, the guidance within the checklist will ensure that they have a full understanding of what it is they need to be doing next.

By using the description element here, you are able to highlight significant tasks or responsibilities for a new joiner. A description that explains what happens next, who's involved, and when the employee can expect the checklist to be returned to them gives clarity and direction to your new joiner.

<div id='#textarea'></div>

---

## Rich textarea

Similar to the description element, our Rich textarea element can be used to display long sections of text that are important for the employee to read - with the added bonus of being formattable. Rich textareas allow you to use different header types, colours, lists and emojis to personalize your descriptive content.

![display only element rich textarea](//images.ctfassets.net/6g4s9n00xmsl/3SN8aEeg1Db6ljAF7UgT6u/e2a343a843456b7a23ee09082831f852/display_only_element_rich_textarea.png)

__Explaining SMART Goals__

If you are implementing the SMART Goals methodology for the first time with your employees, then it may be useful to take some time to break down the description of how SMART Goals work.

With a rich textarea, you will have the space to provide a comprehensive description to break down SMART Goals. From explaining the acronym (with different colored headings for each attribute), to how you expect employees to apply it to their own objectives - this element can give you the option to be thorough with your explanations.

__Employee Learning__

Whether as a part of your employee onboarding or for your employee development plans, the rich textarea element can be used to facilitate employee learning. You might want to reference a segment of text from an article or paste in some other relevant material.

This element is particularly versatile when you're uploading large volumes of text.

__Company Values__

An idea that might be valuable for setting better-aligned goals could be using the rich textarea to present your company's core values. With a clear presentation of these values, employees are able to refer to them as they look to set their own goals or OKRs.

The rich textarea can provide an adequate amount of space for you to present your company values or any other informative bodies of text that could be helpful when employees look to make use of a particular app.

<div id='#image'></div>

---

## Image

In some situations, it might be useful for your employees if you include an image alongside a particular question or survey. As the saying goes: a picture is worth a thousand words. Use the image upload element to bring your employees more into the picture. (I'll stop with the clichés now...)

As these picture examples demonstrate - the use of image elements can bring your employees more easily up to speed. Images also help to break up the text and make longer, word-heavy apps more engaging.

__Wellbeing Awareness__

If using our wellbeing or [mood survey](https://www.peoplegoal.com/support/article/how-to-create-a-mood-survey-remote-team), you may consider including an image that presents some information about keeping healthy. Attaching a warm and lighthearted message to this survey could help not just in terms of the employee responses but also for their wellbeing in general.

![display only image](//images.ctfassets.net/6g4s9n00xmsl/2VzgaLU3FbxP6pcD2bONOU/942634b438f68a91244c7b4b2b8b3935/display_only_image.png)

__Development Plan Schedule__

For this example, you can see that we have provided our employees with a template for their expected development plan timelines. The image succinctly depicts the amount of time individuals should look to invest into particular aspects of their development plans - and looks much cleaner than it would be writing this schedule out in bullet points.

![display only image 2](//images.ctfassets.net/6g4s9n00xmsl/3QpCUOq1Oc2Z9OBELTnoZy/1a7deb33ed49556294833ab6413b9210/display_only_image_2.png)

__OKRs in Review__

Here we have incorporated an image within our OKRs app. This will provide employees with an overview of how individuals have performed collectively in the previous year and therefore can enable them to make better-informed decisions regarding setting their next OKRs.

![display only image 3](//images.ctfassets.net/6g4s9n00xmsl/4c6QnCbQjCx1IDs3eFTaDn/0f705c1df2d15514879fc818ca9e0488/display_only_image_3.png)

<div id='#link'></div>

---

## Link

The link element is particularly helpful when an administrator or manager would like employees to interact with a resource or portal away from the [PeopleGoal](https://www.peoplegoal.com/product) platform.

Making use of this element is straightforward - all you have to do is add the element, then paste in your hyperlink and edit the 'Hyperlink title' to inform your employees of where the link will take them. 

You can even edit how the link is displayed so that it is presented as a button or an iFrame. An iFrame will load the website within a drawer on the item itself so the user doesn't need to navigate away from their PeopleGoal item.

![display only link](//images.ctfassets.net/6g4s9n00xmsl/2YghCDRl5d7KlQ5G0UYf6T/de43167b2cab98b8a7b2fe1ed54172de/display_only_link.png)

*Note that some external sites do not allow their pages to be embedded in an iFrame. If your iFrame link isn't loading, you'll need to change the display to a button or web link.*

__External Learning__

You may find that you have a brilliant learning resource that could be introduced to onboarding employees. Access to this website can be bridged directly from the onboarding app to the learning platform. In doing this, the employee will not need to spend time searching for precisely the correct page - they can jump straight to it as they complete the [onboarding process](https://www.peoplegoal.com/blog/5-key-employee-onboarding-process-steps-to-master).

__E-Signature__

For some forms, it may be necessary to request that your employees provide an e-signature to verify their request. The Asset Tracking app is a great example of where the link element would be really useful. As employees confirm the collection or return of any company equipment, they will be required to provide an e-signature by following a link to dedicated recognition site.

With a link incorporated into the form, all the employee has to do is tick the relevant boxes, provide any descriptions and click the link to confirm. It couldn't be easier.

<div id='#file'></div>

---

## File download

Oftentimes, there are essential documents that employees must have access to in order to accurately complete tasks. Our option to include a File download element provides the solution for this in the Display only category.

An administrator or supervisor can incorporate a file download in any template where it might be necessary. To add a file to a template, one must simply select __File download__ and then __Select attachment__ to download and view the specific attachment included in the workflow.

![display only file download](//images.ctfassets.net/6g4s9n00xmsl/3uZjRq2SRlv53yiC42ss9v/a569eae839d8a4856758aa699c2fe01e/display_only_file_download.png)

__Informed Feedback Ratings__

Every company functions with a unique culture and language. Sometimes, the use of such language may require further explanation. In this instance, we can use a file download to present employees with a document that contains all of the instructions regarding the definition of the terms used. 

By providing employees with clearer guidance as to how they should approach their feedback reports, will ensure better alignment and the proper use of company language.

__Onboarding Information__

For the most part, these Display only elements follow a recurring trend - that being the provision of information to be seen by employees. This is why so many of these elements become useful when onboarding new employees.

Here in this example, we can use the File download element to provide [new joiners](https://www.peoplegoal.com/app-store/template/new-joiner-survey) with access to crucial documents for their onboarding. Whether for learning about the company or presenting the core values and history of your organization, these file downloads can enable a streamline transfer of information to your workforce.

<div id='#profile'></div>

---

## Profile value

For the last element of the Display only category, we turn our attention to the Profile value field. This element can be used to refer to any existing data that is recorded about an employee on their [custom PeopleGoal profile template](https://www.peoplegoal.com/support/article/profile-templates). When an employee comes into fill in their workflow, this field will be populated with the relevant information from their employee profile. 

![display only profile value](//images.ctfassets.net/6g4s9n00xmsl/5XU52z9mSn58HtfwbuzbYI/632e7d057d2475ec521225fd20023f7d/display_only_profile_value.png)

To set up this element:

- Specify the name for the field
- Select the participant whose profile value should be referenced
- Select which profile template you want to reference (remember, you can have any number of different profile templates)
- Then select the profile element to reference

You may also toggle 'Keep existing items updated' in order to ensure the field remains up to date should there be any profile changes. This is useful for an app like a development plan, where the employee supervisor and role title may change over time. But for "point in time" apps like [360 Feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) or a Performance Review, you'll want 'Keep existing items updated' to stay off so that when you refer back to the item in future it shows the role title, team, etc. at the time the user completed their item.

__Performance / Competency Review__

If your company has a specific interest in monitoring the development of your employees then you may emphasize the importance of tracking [employee competencies](https://www.peoplegoal.com/blog/core-employment-competencies-explained). By the time a performance review comes around, either quarterly or annually, this then opens up an opportunity to measure performance against the fulfillment of competencies.

In your performance review, you may decide to integrate some Profile value fields that reference company and role-specific competencies, where these have been created on the employee profile template.

__Exit Interview__

As sad as it is to see someone leave, unfortunately, the day will come where an individual moves on from your organization. The process of running an exit interview can be tedious, especially when working out the specifics about an employee that are important to incorporate in their exit documentation.

With PeopleGoal, you can make the process ever so slightly less painful by incorporating Profile value fields in the exit interview workflow. You may wish to review their final salary on departure in order to inform the expected compensation for their replacement, or pull their Hire Date so you can easily calculate their tenure.

---

[Next up, learn about Text elements for capturing written responses from your app participants.](https://www.peoplegoal.com/support/article/text-elements)

Display only elements present read-only information like employee instructions and tips for using the app.

What do display only elements do on PeopleGoal:?

# App Elements

__Elements are the form fields that make up your app template. When building or editing apps, there are over 30 different types of elements to choose from! This allows you to build out completely custom workflows that capture all the data you want to track within each app.__

This section explains how each of the elements works and how you can edit these in your app template. We've also got some handy examples of each element type so you can understand how they're applied across our different types of apps. If you're not familiar with how to add and edit elements, have a quick look at our [Editing App Templates article](https://www.peoplegoal.com/support/article/apps#edit) to get you started.

There are six different categories of elements and over 30 different element types to choose from! Click a category name below to learn about its elements.

- [Display only](https://www.peoplegoal.com/support/article/display-only-elements)
- [Text](https://www.peoplegoal.com/support/article/text-elements)
- [Option](https://www.peoplegoal.com/support/article/option-elements)
- [Numerical](https://www.peoplegoal.com/support/article/numerical-elements)
- [Calendar](https://www.peoplegoal.com/support/article/calendar-elements)
- [Web](https://www.peoplegoal.com/support/article/web-elements)

Learn how each of the PeopleGoal elements work within the app templates

Learn how each of the PeopleGoal template elements work to build out a completely customizable HR workflow.

What does a PeopleGoal element do?

App Elements

Display Only Elements

## Peoplegoal Section

To start this Zapier integration process open and log into PeopleGoal and start on the dashboard.

![1-asana](//images.ctfassets.net/6g4s9n00xmsl/3g2toJvoCa7CwdNpau95zK/f719925c16acb227fa55255c33668ad7/1-asana.png)

From the dashboard navigate to the workspace which holds the app you have created for the integration.

![2-asana](//images.ctfassets.net/6g4s9n00xmsl/4mFULKByxhPdsu5foHAGkD/1c513ac9d20234f9f56316862980fa39/2-asana.png)

Select the app being integrated and open to the item view, for this example a bug report app is used to submit a new bug report issue in Jira.

![4-asana](//images.ctfassets.net/6g4s9n00xmsl/74XnSNDgKBBCb8gjvJy3EV/450f5650385cac7bae1a3f781f0caf70/4-asana.png)

Create a new instance of the App, name it and open it. Once open fill out all infomation needed to

![5-asana](//images.ctfassets.net/6g4s9n00xmsl/Nlvz7rRB5J1ER67gLsLVM/0f8d9756456be9db97e63229ecb24e4e/5-asana.png)

![6-asana](//images.ctfassets.net/6g4s9n00xmsl/7oEqWoYILhOTOEL4Ah1lvQ/372edcf1fe74f6834ca8deebbc553a1e/6-asana.png)

As shown in the gif below, In this app we have used a text option, Team Selection, User Selection and Date picker to log the infomation about the bug found. 

![7-asana](//images.ctfassets.net/6g4s9n00xmsl/4uAxfJ70VXMQZFxdRFVux6/bc6e212afb331e8b17a3548d594c22ea/7-asana.gif)

Once the app is filled out with the infomation submit the app and open Zapier.

## Zapier Section

### PeopleGoal Zapier Section

Once the PeopleGoal app has been created and saved we will move onto connecting Peoplegoal to Zapier. Once you log into your zapier account navigate to the dashboard and click on the button in the top left "MAKE A ZAP".

![1-jira](//images.ctfassets.net/6g4s9n00xmsl/6MrF2ixFyWCQb8KAVOcpsu/4f409f5b6fc2c961e718a84547c5e43b/1-jira.png)

This will create a template for a new zapier integration. In the top left of the screen you can click on the text to rename your Zap. This helps to show what the Zap integrates with and is recommended that going into as much detail as possible can help differentiate between zaps if your account holds mutiple zaps between two of the same apps.

![1-jira](//images.ctfassets.net/6g4s9n00xmsl/6MrF2ixFyWCQb8KAVOcpsu/4f409f5b6fc2c961e718a84547c5e43b/1-jira.png)

Once you have named your Zap, select the seach box and type in PeopleGoal and then select PeopleGoal (1.0.0). This feature is Invite only so if this isn't shown in your search bar please contact (email here) to gain access via our Development Team. This process can be shown (insert link to connecting to zapier account here).

![2-jira](//images.ctfassets.net/6g4s9n00xmsl/4NtEKvk0JGt4X7uiY9Jryp/18d6cd056e85ebf03931fa42e1fadd8c/2-jira.png)

Once the PeopleGoal app has been selected we need to choose an event that we want to trigger this integration. For this example want to create a new bug ticket in Jira everytime a bug report is submitted in, so for this example we will use Item Submitted. Once selected click continue to choose account and event.

![3-jira](//images.ctfassets.net/6g4s9n00xmsl/7D9b7kD8ESt1bLX7vNAbZe/28a8c0f9eaea849ffc52513b26ce189e/3-jira.png)

![4-jira](//images.ctfassets.net/6g4s9n00xmsl/1NXgPzjnAr6MABlFfOp2ox/1dc011cab58637c68427ea728243db47/4-jira.png)

Here you will log into your PeopleGoal account which will give you access to link your PeopleGoal account to Zapier. A popup will open with a page to login, use the same login you use to access your PeopleGoal Account. This connection can be disconnected at any time via My Apps from the Zapier. Once the account is selected click continue.

![5-jira](//images.ctfassets.net/6g4s9n00xmsl/3l8RWxDMrNO1sEOaPeOTfM/fb0584af85644b3d3337398e678c5dcf/5-jira.png)

Once the PeopleGoal account in logged in you will be asked to pick which company account you want to associate Zap. This dropdown option helps with accounts that have access to mutiple company accounts like HR managers and Consultants. As an indvidual you will only have access to see and select the company accounts you have access to in PeopleGoal. You can search the company account that is needed and select it, once the account it selected Click continue.

![6-jira](//images.ctfassets.net/6g4s9n00xmsl/1ir7zukdJbazzMhmTc3BMJ/1dde61e1db99e08bbe74dd1882f5de4d/6-jira.png)

Now the company account has been selected you can test your trigger integration with Zapier. Click test and wait for the Item list to be loaded.

![7-jira](//images.ctfassets.net/6g4s9n00xmsl/5MHULXTnKGM7itNah2HAEh/acdab701fd1f51b78ab2a9690061a410/7-jira.png)

![8-jira](//images.ctfassets.net/6g4s9n00xmsl/3RBWlWDofJMSbLtYLoYbLa/96507c9affaabd24b778b2e8ec410e87/8-jira.png)

When the data is found a list of available items to select from will appear. In this list the test item created from the PeopleGoal app from earlier can be found. The search feature can be used to check if the data matches the test app created earlier. Using the search feature is recommended because of the large amount of data shared by the PeopleGoal API. Using the search feature simplifies this and helps to find what data is provided in the item that has been selected. 

![9-jira](//images.ctfassets.net/6g4s9n00xmsl/4WXY564jNcNxObiOWIBU2L/a0367a756bb7be09cb08be3a90fdf058/9-jira.png)

Once the correct item has been selected click continue to move onto the Jira section of this zap.

### Jira Zapier Section

This finished the PeopleGoal section of this integration. Now we are shown another App & Event Selection list. Search for Jira Software Cloud and select the app.

![10-jira](//images.ctfassets.net/6g4s9n00xmsl/2pwssJHsa6Xh44SxHdehPn/95ed28e78b7e3853bddc354112e4d6d3/10-jira.png)

In this example integration a bug report is being created in [PeopleGoal](https://www.peoplegoal.com/product) which will trigger a new bug report issue in Jira, this means "Create Issue" will be selected as the event trigger.

![11-jira](//images.ctfassets.net/6g4s9n00xmsl/5cEghpPnrQJg3iN55YJwUT/fc6a9afccd9216486900950b663498c6/11-jira.png)

![12-jira](//images.ctfassets.net/6g4s9n00xmsl/5VXF6xRhmRmzKnzmnbgFzv/fcb87851fb07fed0a0121a93ac9aad00/12-jira.png)

After the App and Event are chosen zapier will prompt a Jira account sign in. If a Jira account hasn't already been linked your account in zapier, this will prompt a pop up screen to login in.

![13-jira](//images.ctfassets.net/6g4s9n00xmsl/1iaYjK6IFGyAB6wrnxJGAX/b5d8659cdf6280771c26df34eb65f48e/13-jira.png)

Next it will ask to grant permission to Zapier to access a Jira/Atlassian account, check if the account authorized in correct then click accept to continue. 

![14-jira](//images.ctfassets.net/6g4s9n00xmsl/5ASiAjvZMGuhL6ghAYYTTH/d0baf0de166d0f49425ff6dc5cf52ac1/14-jira.png)

![15-jira](//images.ctfassets.net/6g4s9n00xmsl/1YzJnFJucPJppxqk66ZFsF/a70ab6288b1a0f3e63c81203815b7e38/15-jira.png)

![16-jira](//images.ctfassets.net/6g4s9n00xmsl/4JsI4J7mU2aBpPeOkVCoET/6275eacbc299472fc10ea84ad94b0623/16-jira.png)

Next step is to customize the Issue data and where its being sent in Jira. First start with the Project. Select which Project is being integratated with PeopleGoal. In this example the Bug Reports Project is being selected.

![17-jira](//images.ctfassets.net/6g4s9n00xmsl/7tIbhnQEhzwUVSCibSmHYe/e06155ec4035fcad21e799ab0c0b214b/17-jira.png)

Once Project has been selected next is the Issue Type selection. Here is where the Issue is selected that is being integrated with the PeopleGoal App. As the example app used is a bug reporting app in PeopleGoal the destination for this data would be a new bug report Issue in Jira so the bug report issue type is selected.  

![18-jira](//images.ctfassets.net/6g4s9n00xmsl/3ktK39TQhN7O6B05vxaSDq/d3398e3bc749bc6a1b8f6020871c1547/18-jira.png)

Next Step in the Issue creation is accessing the data shared by the PeopleGoal app. Here we select Summary which provides zapier with a drop down box of all the possible infomation shared from the bug report via the PeopleGoal API. As PeopleGoal offers a highly configurable form builder there is alot of data available for selection but it has been simplified for the selection process.

![19-jira](//images.ctfassets.net/6g4s9n00xmsl/1VOY7NcvBSnU2A1Di6UxDR/e41759900cb3ff54b4143679b9b36807/19-jira.png)

When searching for the app data needed to attach to this Zap using "Simple Dataview" in the search can help find the data send from the App selected. In the example "Simple Dataview Name" is searched to easily find the name used when the app was created back in the PeopleGoal section. This selection process is the same when selecting any form data from the PeopleGoal app.

![20-jira](//images.ctfassets.net/6g4s9n00xmsl/1rXbZL6RXYSQ09rkJ0sqxV/d0ba386ac9ca2802c933ec2e5d36d3c6/20-jira.png)

In Description again access is needed to the text input data from PeopleGoal app. Again Simple Dataview is used to find the text input "Enter Bug Details" is that is shown in the list below. This can be added from the list along with other mutiple data inputs that are needed.

![21-jira](//images.ctfassets.net/6g4s9n00xmsl/6nkQgee5NHdM9LQygCJbwD/f65b26b986dc4ac163061bf651eb49ad/21-jira.gif)

In the next step a Reporter and Assignee are selected for this bug report issue. Once this is done, click continue to finish the Issue Creation step.

![22-jira](//images.ctfassets.net/6g4s9n00xmsl/1vvQiun7wXDEUgHQyfBchv/6c9e1b391406bf2d907ef38e67f89e28/22-jira.png)

![23-jira](//images.ctfassets.net/6g4s9n00xmsl/2TGZDxPeXc1fVtUhzkWunl/860ddcc3a2c6d66d91665f3e791237df/23-jira.png)

Now in this step a test is run on the data coming through from PeopleGoal through Zapier to Jira. Zapier will give a visualized issue layout to see what infomation is being sent through and if the data is linked correctly. If this all looks correct click test and continue. This process will help troubleshoot if the format of the data being sent matches what is needed by Jira to create the Issue.

![24-jira](//images.ctfassets.net/6g4s9n00xmsl/4qlRfaNcm0k5ZTk3TTOYts/0d190bd5f1e36f73a34294a3f05368c3/24-jira.png)

When the test is done a slider at the bottom of the screen will appear to turn on the Zap. Click the slider that is located in black at the bottom of the screen click. This may take a moment to go green but once it does click the back button at the top left of the screen to go back to your Zaps page. If the slider on the Zap is green it will indicate the Zap is up and running.

![25-jira](//images.ctfassets.net/6g4s9n00xmsl/7H9v7TMD5vmsN3ZbBZjHFJ/6b2a588ae230037d77d6a8808869ba2c/25-jira.png)

![26-jira](//images.ctfassets.net/6g4s9n00xmsl/2lJlTK0miHizHFIrpSU9AA/fb9a3ef9fecfc58b6adc43d9fd9b658a/26-jira.png)

Now the Zap is actice, Open up Jira and check if the data send correctly.

## Jira Section

Once the Zapier Integration is up and running and have submitted the PeopleGoal test app, move across to Jira to check if the data sent is correct. Open Jira to either the Your work tab or Projects. Select your Bug Reports project.

![27-jira](//images.ctfassets.net/6g4s9n00xmsl/40q3r440wFcyhI5malQXbX/a48f9e0ec3dad3c10a9c4b7b38006ba0/27-jira.png)

![28-jira](//images.ctfassets.net/6g4s9n00xmsl/4f2z5qtulv6xc235U4RHNl/5f9e46cb9cee951cad7b25ba146b39e5/28-jira.png)

Open the Issue card and check the infomation is matching the content sent via the PeopleGoal App. 

![29-jira](//images.ctfassets.net/6g4s9n00xmsl/6S1mElVhCRJG6jfCKoQsPL/05d5521e2b2e0885f4b1617243f5d806/29-jira.png)

![30-jira](//images.ctfassets.net/6g4s9n00xmsl/5kPwxAPKSrlZSDi1lpM2HW/d285b3449a24a5d896ddd875e10a8bfa/30-jira.png)

If the infomation is correct then the integration setup is complete. This process can now be used to setup and create more Zaps that allow more integration more data between PeopleGoal and Jira.


This technical article goes through step by step PeopleGoal Zapier integration with Jira.

PeopleGoal and Jira integration

# Profile Templates

__[PeopleGoal](https://www.peoplegoal.com/product) allows an account owner to create any number of custom profile templates to capture your important employee data. Profile templates contain multiple fields that you define, that you can then leave to the employee to fill out or add the data yourself. Each field also has different permission types, so you can control who can view and edit every field on the template.__

To start building a new profile template, click on your profile image (or default image) in the bottom left corner, then select __Profile__.

---

## Create a new profile template

- When you open your Profile menu, you'll land on the __Profile__ tab which shows your personal read-only profile.
- Click the __Company profile__ button to the right of this view, then select __Account owner actions__.
- Select __Create a new profile template__ to begin. You'll need to give your template a name and description. Because you're able to create multiple templates, the description will help your colleagues to choose which template best suits their role. For example, you might want to create custom fields just for managers that are not required for an employee who has no direct reports.
- Then select whether you'd like this template to be the default profile template for everyone in the account.
- Click __Create profile template__ and you can start to edit the template fields.

![peoplegoal edit profile](//images.ctfassets.net/6g4s9n00xmsl/5jRhOsyMMqitdSJDT0k5s/fae7142167b07d0565d54021a92feeab/peoplegoal_edit_profile.png)

---

## Edit a profile template

Once you've created the profile template details above, you'll be taken back to the __Profile__ profile tab where you need to click the __Company profile__ button in the top right again.

- In this drop-down, select which of the profile templates you want to edit (if you have more than one).
- Click __Account owner actions__, then select __Edit profile template__. 
- You'll see all of the read-only fields now become editable, and you can start to create your custom template.

### 1. Create the template structure

- Profile templates contain __Sections__ and __Elements__.
- Sections help you to group your data and make the profile easier to read, and __Elements__ are the indiviudal data fields that need to be filled out.
- Click __Add section__ to begin. Double click the __New section__ title to change the Section name - for example, "Employee details".
- Next you're going to start adding your profile elements. Click __Add element__ then select the element type.

### 2. Configure elements

- Each element is a data field on the profile template that you can customize.
- Hover over the right-hand side of the element until the three dots appear. Click these to open the __Element configuration__.
- Click __Edit element__ to change the field details.
- Click __Duplicate element__ to create an exact copy of this element. This is a great option to quickly duplicate things like rich-text fields where you've defined character limits, or single select elements where you've defined your drop-down fields.
- Click __Change section__ to move this element into another section of your template.

### 3. Visibility & control

In addition to the configuration, you can control the visibility of each profile section and each individual element.

- For a section or an element, hover over the right-hand side until the three dots appear.
- Under __Visibility & Control__, select the permission type for your section or element:

- __No selection__: the field is visible to everyone in your account, and editable by the profile owner as well as account owners. This would cover basic details like the employee's name, job title and office location.
- __Private__: the field is visible only to the profile owner and account owners. Both can edit the response to this field. This would include things like the employee's home address and their emergency contact.
- __Protected__: the field is visible to the profile owner, but editable only by account owners. You can include salary details and employee ID here.
- __Account owners only__: the field is not visible to the profile owner, only to the account owners. These would be things like their pay band or job classification for succession planning.

Once you're done, click __Finish editing profile template__ to save all of your changes.

![peoplegoal reviews profile template](//images.ctfassets.net/6g4s9n00xmsl/1kc0enSj471po8mjjwAtaE/019e80fa86fc4929d8457130bc413d8b/peoplegoal_reviews_profile_template.png)

Account owners can create profile templates to include custom employee information for every user in your PeopleGoal account.

Click on your profile image in the bottom left of your PeopleGoal account, then select the profile template dropdown. Click Account owner actions to proceed.

How do I create a PeopleGoal profile template?

# Admin & Account Management

Account owners are the key administrators of your PeopleGoal account. As an owner, this guide will help you with your billing and subscription details; with creating, updating and managing users and relationships; building custom profile templates and some basic troubleshooting tips.

---

## Key Terminology

These are some of the key terms everybody will come across when using PeopleGoal.

__Apps__ are your processes / workflows - the core functionality of your account. In Performance Management for example, you'll have individual apps for reviews, one-to-one meetings, [360 feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) and OKRs/SMART goals. Or in our Development example below, you see apps for Training Approval, Development Plans and Career Development One-to-Ones. An app has a template for the form you want to complete which is completely customizable.

![peoplegoal apps](//images.ctfassets.net/6g4s9n00xmsl/7Ee2z5nisnprzGNj8yQOBj/1292c265fca411d9a11f3aca9cf14071/peoplegoal_apps.png)

__Items__ are an instance of an app created by a user. The performance review for employee Jane Smith is an item  created in the Reviews app, or your Q1 objectives will be individual items created in the OKRs app.

![peoplegoal items](//images.ctfassets.net/6g4s9n00xmsl/5I91tNEdWD0i0DAqhzYU2n/18961b4e6fa0c584cdb52e18cef19d26/peoplegoal_items.png)

__Workspaces__ are the containers for all of your apps. Think of it as the topic or category for all of the apps within a workspace, like Performance Management or Employee Engagement.

![peoplegoal workspaces](//images.ctfassets.net/6g4s9n00xmsl/sXLowZIwz3KbyjDBgGPPO/d289fe72eb40668274324474da14b0ce/peoplegoal_workspaces.png)

__States__ are stages in the app workflow. Every item can move through many states, with each state's participant being responsible for completing the form in that state and sending it on to the next state.

![peoplegoal states](//images.ctfassets.net/6g4s9n00xmsl/2XzPFjOm0SjP3AVoreDMeW/06804cd5698b1436086ba332503ce57f/peoplegoal_states.png)

__Permissions__ control the visibility of items, apps and workspaces. You'll see permissions like "create only", "create and edit" or "view only". Permissions can be configured right down to the app level, so you can have different workspace and app permissions.

![Permission updated 2.2](//images.ctfassets.net/6g4s9n00xmsl/3Pr1FFLhiV6XvhF7Rx06fp/f097c173d3fa28fba5ff4d343123197c/Permission_updated_2.2.PNG)

__Relationships__ are a link between two users - like Manager/Direct Report, Supervisor/Employee or Mentor/Team Member. You can have many relationships on [PeopleGoal](https://www.peoplegoal.com/product), meaning you're not limited to the traditional employee/line manager views.

![peoplegoal relationships](//images.ctfassets.net/6g4s9n00xmsl/DZra0ByDP4bXIeSLXyEUg/98b94848217018833d4583a0cdaa7ef3/peoplegoal_relationships.png)

__Teams__ are groups of users. You can belong to many teams, and teams can connect to one another to build out a matrix organizational structure that reflects your actual working groups, not just a strict organizational hierarchy.

![peoplegoal teams](//images.ctfassets.net/6g4s9n00xmsl/4GtF0emkKOIz2qk4ktwghd/d041f995e3d324334e9c8c4b3742f192/peoplegoal_teams.png)

---

Let's go over [creating custom profile templates](https://www.peoplegoal.com/support/article/profile-templates) for all of your account users.


Account owner-only features including profile templates, creating teams and relationships for the full account and managing your billing

This section of PeopleGoal's Support Center covers account owner-only features: profile templates, creating teams and relationships and managing your billing.

PeopleGoal Admin Guide

Administration & Account Management - PeopleGoal Support Center

Administration & Account Management

For account owners: profiles, account settings and billing

Profile Templates

# Text Elements

__The Text section is full of elements that will allow participants to provide written responses in the workflow. The text elements are extremely versatile and are incorporated into almost all of our apps, in one way or another.__

For all text elements, the __Repeatable__ toggle option will allow participants to generate additional text fields and create lists in their responses. You can set a character limit for minimum and maximum characters, or leave the max. character field at 0 to have no character limits. You can also specify the line length text inputs and text areas - you'll see the element preview size change when you increase/decrease the line length. 

![text elements](//images.ctfassets.net/6g4s9n00xmsl/5tb5IBBgQ2zsnV7MLA0lsg/7210cf267b97a9615b754f95289bceb2/text_elements.png)

There are five text elements:

- <a href='#input'>Text input</a>
- <a href='#textarea'>Textarea</a>
- <a href='#multiline'>Multiline</a>
- <a href='#richtext'>Rich textarea</a>
- <a href='#email'>Email</a>

<div id='#input'></div>

---

## Text input

This option will generate a single line box for employees to enter any responses. Typically this element is used when the employee is expected to give a short, written response. You can also switch on the __Repeatable__ toggle here to allow participants to create lists.

![text text input](//images.ctfassets.net/6g4s9n00xmsl/6MjYKcNKBs9HG6Djvks9Xy/ab75f2ba4f4a865a19d07010bc92e735/text_text_input.png)

__Employee Details__

The true value of text input is seen in its application for gathering information that is short but still very important. In this example, the text input element is clearly the ideal solution for gathering an employee details such as their first name, last name and other relevant information such as role title and their department.

There is no need for an extremely long block of text here as even the longest name or title is highly unlikely to take up multiple lines of text.

__Defining a KPI__

This example may not apply if you follow a different approach when using KPIs in goal setting, however, if your company promotes setting definitive and succinct KPIs then this can help you. Since the text input element is intended to present a short response, it is useful to encourage employees to give short and sweet definitions for their [KPIs](https://www.peoplegoal.com/blog/key-performance-indicators).

__Pulse Surveys__

Running a weekly or regular [pulse survey](https://www.peoplegoal.com/glossary/employee-pulse-survey) is a great way to ensure that employees are well engaged with their work. The majority of responses will be multiple choice select options, however, it can be useful to prompt employees for some brief descriptions of their thoughts and feelings towards the company or their week in general.

Using a text input element, you can gather information by asking for them to 'describe their week in 3 words'. The single line response will be more than enough space to gather their responses.

<div id='#textarea'></div>

---

### Textarea

The Textarea element is catered for more in-depth text responses. This larger box will be useful for gathering text responses that are longer than a single line response, but don't require any formatting. In a variety of scenarios, the text area element can be an extremely useful element for gathering information from your employees.

![text areae](//images.ctfassets.net/6g4s9n00xmsl/MPpOodxks1d9dn1a7xmgx/6862c315ac22a2ccbbef070667f05c68/text_areae.png)

__Comments box__

As thee textarea provides a lot of space for in-depth responses, it can be applied effectively to function as a comments box. For example, in the tracking stage of an objective - the textarea element is a great solution that enables employees to post regular updates and provide information about their progress towards their KPIs. Make this a repeatable element and users will be able to add a new section for each individual update they provide.

__Weekly Tasks__

An additional benefit of the textarea element is its capacity to encourage employees to provide more in-depth responses. This is encouraged in an unspoken manner as the size of the textarea box clearly indicates that theree is an expectation for the employee to type in more than a one line response.

Within the weekly tasks app, this provides an ideal means to prompt employees to give a well-detailed account of their activities. From breaking down their tasks on an hourly basis or simply listing what they achieved each day, the text area element caters to these more long-winded responses. 

<div id='#multiline'></div>

---

### Multiline

Our multiline element is ideal for sharing an address, but it has many alternative, flexible applications. The multiline element does as it says - it provides a series of single line text boxes.

To add or remove additional boxes, go to 'Edit multiline' and either define another input or delete a particular box. These can then be altered to provide a half-length box or a full-length text box depending on what you require. Moreover, you can provide labels for each text box - these can either be displayed above or in-line with each box.

![text multiline](//images.ctfassets.net/6g4s9n00xmsl/728iU37CpnLEU733Nst9O3/34897aa5a5215a9dcc5d10a193ecfdc0/text_multiline.png)

*Note: with multiline elements you can make each individual line required or not-required. Click 'Show options' to switch on/off required lines.*

__Employee Address__

The most obvious approach for using this multiline element is the option to provide a clearly broken up set of text boxes to gather data on employee addresses. This might be important to include in the [onboarding process](https://www.peoplegoal.com/blog/5-key-employee-onboarding-process-steps-to-master) ensuring that the new joiner has shared their current address with your company.

You can label each line of the element with instructions as to the information expected for each line. For example, you might use: 'House/ Flat number', 'City' or 'Zipcode'.

__Key Performance Indicators__

Beyond using the multiline element simply the means to gather employee addresses, you might look to use this element when gathering responses that are ranked or to be prioritized. In this instance, an employee's [KPIs](https://www.peoplegoal.com/glossary/key-performance-indicators-kpis) may be ranked from 1-5 in terms of importance or urgency. 

Consequently, we could use the multiline element to facilitate setting these KPIs in a specific order. As there is no option to add additional responses for this element, the administrator is also able to limit the maximum number of KPIs that can be set by any employee.

<div id='#richtext'></div>

---

### Rich textarea

If you're looking for an element that can be used as a graphical word processing program, then the Rich text rea is the element for you. This element provides an all-rounded solution for any of your text-based requirements. Employees are able to embed content, create bulleted lists, add headers, colors and emojis to personalize their responses.

![text rich textarea](//images.ctfassets.net/6g4s9n00xmsl/3PFis5RpyL3B9SC6XMO77h/2d7a36b5e6bc1755e245f1c351529a95/text_rich_textarea.png)

__Development Logs__

Within your development workspace, you may wish to create a dedicated app for logging and tracking employee learning and development. Development programs can be multifaceted and may draw on a wide range of training programs or other learning facilities. As a result, it is useful to encourage employees to record all of the various aspects of their [development](https://www.peoplegoal.com/blog/employee-development) in a single document.

With a rich textarea, you can set up boxes to contain several rows for very long entries. The element can also make use of the *repeatable* function, thus allowing employees to log multiple events or specific timeframes within their accounts of their [personal development](https://www.peoplegoal.com/blog/personal-development-objectives).

__Exit Interview__

Whilst a manager will have a strong awareness of the responsibilities of their employees, occasionally certain tasks may go unrecognized. This is where an [exit interview](https://www.peoplegoal.com/blog/exit-interview-questions-that-you-should-ask) can be used to attain information from an employee as they give a full debrief of the various responsibilities they undertook in their role.

With options for bulleted responses, it becomes easy enough for the employee to list the different types of tasks they performed and with whom each would be involved.

<div id='#email'></div>

---

### Email

As we arrive at the final element in the text category, the option to prompt employees to provide an email has obvious benefits. The email element can be incorporated as a way to gather employee information. Alternatively, it could be used for linking a particular individual with another item. When including an email element into a workflow, there is typically a need for this email address to be used directly or indirectly in line with the immediate item.

![text email](//images.ctfassets.net/6g4s9n00xmsl/6uedU9ga5egAMaJC3n8igf/833b392b4fc26f74c1971e63e8162e39/text_email.png)

__Contact List__

With the email element, there is the option to include *repeatable* responses. This means that an employee can list multiple email addresses if it is required. One example where this may be the case is in establishing an employee contact list. Either grouped by teams or otherwise, we can enable one employee (responsible for their department or associates, etc.) to enter the email addresses of multiple individuals.

With a single workflow containing all of the necessary contact details, employees can more easily access the information required to reach individuals that they may not regularly communicate with.

---

[Next, let's take a look at the Option elements you can use to create select boxes, drop-down lists, user and team tags.](https://www.peoplegoal.com/support/article/option-elements)

Text elements ask for written responses from app participants, and have loads of flexible applications in the HR workflow.

What do PeopleGoal text elements do?

Text Elements

# Teams

__A team is a group of users on [PeopleGoal](https://www.peoplegoal.com/product). It's an extremely flexible way to group employees together in ways that reflect your actual working groups. You're not limited by a strict hierarchical structure and you can build out complex matrix organizational charts.__

A team can "belong" to any number of other teams. Connect your teams up in any number of organizational layers, including cross-team alignment. Users can also be members of any number of teams which gives lots of scope to reflect not only their core office location but also any special projects and temporary working groups they're a part of.

Teams has the most impact on how you structure your app permissions. There may be a lot of changing of teams as you build out your account, but luckily any changes are quick and easy to implement.

![peoplegoal teams](//images.ctfassets.net/6g4s9n00xmsl/4g1hBAnjhBxIl1S9EcBDei/cdae1cca997b7909dca4b7509d3b2bb3/peoplegoal_teams.png)

---

## Create a New Team

- Click __Create a new team__ to get started.
- Add a team name and description. The description will help users know whether this is the team they want to join if they send a request.
- Select which team(s) this new team should __belong to__. Search in the filter to add parent teams.
- You can also select which team(s) should belong to this new team! Search in the filter to add child teams.

### Team Visibility

Teams can be open or private.

- __Open__ teams are visible to everyone in the account, and anyone can join this team without needing approval. Open teams are great for volunteer or special project groups.
- __Private__ teams require a team owner to approve user requests to join. The person who creates the team is by default the team owner, and they can assign owner rights to other users and manage requests.

---

## View Your Teams

- Click on the __Teams__ icon in your navbar to open the full teams view.
- The teams view is split into __List view__ and __Network view__ - shown as tabs on the lefthand side.
- The List view shows an alphabetical list of all teams in your account, as well as their connection to other teams.
- The Network view shows you a visual org structure of how each team connects to every other team.
- Click on a team name to open the full view (if you have access).

---

## Teams Pages

- An individual team page is made up of the __Feed__, where team members can share posts and comments.
- The __Users__ tab shows you all of the team members in the account.
- __Requests__ is where team owners can approve or reject requests to join the team.
- __Actions__ is where individuals can leave the team, and owners can edit the team details.

### Add team members

- After the team is created, go to the __Users__ tab.
- Click __Add users__, then search for colleagues to add to your team.
- When you've added their name you can select whether to make them a team owner as well.
- Click __Add users__ to save.

### Remove team members

- Go to the __Users tab__ where you'll see a list of all team members.
- Click __Remove user__ in the far right to remove them from this team.

### Join a team

- Anybody can join an open team or request to join a private team.
- Open up the team name and click the __Actions__ tab, then __Join team__.

### Manage requests to join

- Team owners of private teams need to approve or reject requests to join.
- To do that, go to the __Requests__ tab and click to approve or reject the new team member.

### Leave a team

- Team members can remove themselves from teams.
- Click the __Actions__ tab, then __Leave team__.
- If you're a team owner make sure that you assign owner rights to another team member before you leave!

---

## Edit a Team You Own

- Team owners click the __Actions__ tab, then __Edit team__.
- Click the __Expand__ button in the far right to change any settings.
- Click __Save changes__ to save your updates, or __Cancel changes__ to leave without saving.

### Team name and description

Change the team name and description. This is visible to everyone in the account so be careful with confidential information.

### Team relationships

- Change which teams this group belongs to, and which teams belong to it.
- Type in the team names in the Search fields and click out to save.

### Team privacy

Select whether to make this team private or open.

### Team image

- Click the default image to change this.
- You can either __upload an image__ or __search for an image__ from our stock photography library.
- Team images will be circle cropped throughout the app, so it's best to upload a basic square crop here.
- Click __remove image__ to delete your selection and return to the default image.

### Delete team

Team owners can permanently delete their team. This action is not reversible and you'll lose all posts and comments from the Feed, so proceed with caution!

Teams are groups of users on PeopleGoal. Anyone can create a team, and they're a flexible way of building your organizational structure and working groups.

Anyone can create a new team - not just account owners! Select the Teams menu in the lefthand navbar, then click "Create a new team".

How do I create a PeopleGoal team?

Teams

# Workspaces for Pros

__Workspaces are the containers for all of your apps. Think of a workspace as a category within your account - like Performance Management, [Onboarding](https://www.peoplegoal.com/blog/onboarding-a-new-employee) and Talent Development. They make your PeopleGoal account easy to navigate for users, and easy to manage for owners. Workspaces have their own permission settings which allows you to control who can see, create and edit all of the data contained in the workspace.__

Before you dive in make sure you've read the [Workspaces article in the Getting Started guide](https://www.peoplegoal.com/support/article/install-a-workspace) so that you've got the fundamentals down - how to install a workspace template, how to navigate the workspace and what the workspace settings are.

In this article we'll show you how to create a new workspace from scratch, how to set your workspace permissions and how to set up app folders in the workspace.

---

## Create a New Workspace

- Click on the __Workspaces__ icon in the navbar.
- Click __Create a new workspace__ and select __Blank template__.
- Give your workspace a catchy name and a description. These will be visible to everyone in the account regardless of their access permissions.
- You'll see a banner saying "This workspace is in draft mode". This means it's only visible to you, the workspace owner, until you're ready to publish it. Publishing means making the workspace visible to everyone else. You can publish your workspace now or come back to the Settings to publish it later.

![peoplegoal create a workspace](//images.ctfassets.net/6g4s9n00xmsl/2EN5ADa82CcluasBRpAsHd/6c68bf4e657c05811a49f4cd98793096/peoplegoal_create_a_workspace.gif)

Next you're going to set up the basic workspace settings.

- Click your __Settings__ tab to get started.
- - Click __Expand__ in the far right of each settings section to make your changes.
- Click __Save changes__ to lock in your updates, or __Cancel changes__ if you don't want to save any updates.

![peoplegoal workspace settings](//images.ctfassets.net/6g4s9n00xmsl/6qUQf4mWvC9leGD1QlJWag/0de59f5504b713ec0666a48c264c90ad/peoplegoal_workspace_settings.png)

### Details

Change the workspace name and description (great for checking if you made any typos when you created your new workspace).

### Image

This is the workspace cover image.

- Click the default image to update this.
- Select __Upload image__ to upload your own image file or click __Search for an image__ to browse the stock photography library.
- The workspace image is cropped 3:4 in the overall workspaces area, and circular cropped in the individual workspace view, so make sure to choose an image that works for both.

### Style

Select the workspace color and display icon. By default these will be the same for any new apps you create within the workspace.

### Status

You're already working in draft mode. When you're ready to publish your workspace, either toggle the "Draft" button to "Published" and save your changes, or click __Publish workspace__ in the yellow banner above.

---

## Configure Workspace Permissions

The __default permisssion type__ is listed in the drop-down button (generally this will be "Create only"). This is the access level that applies to everyone in your PeopleGoal account.

- Click __Configure specific permissions__ to set up other access rights by exception. Access can be given to teams (groups of users) or to specific users.

![company culture survey permissions](//images.ctfassets.net/6g4s9n00xmsl/50i8liy8Ubb73Uv9FrOzF1/27efc0a9cb40a10e88b489a5640fd5bc/company_culture_survey_permissions.png)

As an example, you might create a Performance Management workspace that will contain a suite of performance management apps for goal-setting, one to ones and performance reviews.

The __default permission__ type will be "Create only", so that all employees on your PeopleGoal account can create their own [OKRs](https://www.peoplegoal.com/blog/okrs-for-better-strategy-alignment) and complete [performance reviews](https://www.peoplegoal.com/guides/performance-reviews), but they can't view the OKRs or reviews belonging to their colleagues.

You can then __configure specific permissions__ to make your Human Resources team additional workspace owners. Everyone in this team would have workspace owner rights, just like you do.

You could also configure a specific permission for your CEO to give them "Create and view" access. They'd be able to create their own items and view items for all other employees - without having owner rights to change workspace settings.

Remember to hit __Save changes__ to lock in your updates.

Head over to our [Permissions & Visibility article](https://www.peoplegoal.com/support/article/permissions) to understand permissions in detail.

---

## Set up App Folders

Once you've got your settings and permisssions configured, click on the __Apps__ tab to add workflow apps to this workspace. Either [install an app from our App Store](https://www.peoplegoal.com/support/article/install-an-app) or [create your own custom app](https://www.peoplegoal.com/support/article/apps).

Once you have a few apps added to the workspace you've got an extra way to organize your apps - called __Folders__. Using folders adds a menu list to the lefthand side of your workspace, and allows you to group common apps together. This is especially useful when you've got five or more apps within a workspace.

### Create the folder view

- Select __Use folders__ to start creating your folders.
- You'll start with two default folders called __Home__ and __Uncategorized__.
- Click the pencil icon next to the __Folders__ title to rename your "Home" folder. Click on the "Home" title to edit.
- Click __Add folder__ to create and name more folders.
- Click the pencil icon again when you're done.

![peoplegoal add folder](//images.ctfassets.net/6g4s9n00xmsl/6auY3fghOLYcY74Zo2daqV/55814a1488e360b715962df20c012670/peoplegoal_add_folder.png)

### Add apps to folders

- Click the __Uncategorized__ folder to start sorting your apps.
- Click the cog icon in the bottom left of an app, then select __Move to folder__.
- Choose which folder to send this app to, and repeat for all the other uncategorized apps.
- Now to access your groups of apps, just click the Folder title and your categorized apps will appear.

### Change an app's folder

- Open up the current folder the app is in.
- Then click the cog icon in the bottom left of the app and select __Move to folder__.

![peoplegoal add folder](//images.ctfassets.net/6g4s9n00xmsl/6auY3fghOLYcY74Zo2daqV/55814a1488e360b715962df20c012670/peoplegoal_add_folder.png)

### Remove App Folders

- If you want to switch back to the regular workspace view, click the pencil icon next to the __Folders__ title to edit.
- Click the red "x" next to each folder name, and all apps within that folder will become uncategorized again.
- Select __Delete folder__ to confirm.
- Keep deleting all of your folders until you're back to the default workspace view.

---

Now that your workspace is ready to go, let's go into detail about [creating and editing apps](https://www.peoplegoal.com/support/article/apps).

Workspaces are the containers for all of your apps. Learn how to create your own custom workspace and manage the workspace permissions.

Click on your Workspaces area in the navbar, then click "Create a new workspace". Select "Settings" to edit the workspace details and control the permissions.

How do I create a PeopleGoal workspace?

Workspaces

# Create a PeopleGoal Account

__First things first - you need a PeopleGoal account. Learn how to create a new account for your organization, invite your colleagues to join your account and manage requests to join the account. Simple!__

Jump straight to:

- <a href='#set-up-a-new-account'>Set up a new account</a>
- <a href='#invite-others-to-join-your-account'>Invite others to join your account</a>
- <a href='#import-userst'>Import users</a>
- <a href='#join-an-account'>Join an account</a>

<div id='set-up-a-new-account'></div>

---

## Set up a new account

- Go to [the sign-up page](https://www.peoplegoal.com/sign-up) and click __Create a new account__.

![peoplegoal create an account](//images.ctfassets.net/6g4s9n00xmsl/2XnUujHApF0fyS0LX5LL8u/7bc5eddf8561f1581dc42218aef26be5/peoplegoal_create_an_account.png)

- Enter your organization's name and give us a few sentences about what you're looking for. This will help our team suggest the best Apps to install to get you started.
- Click __Next__ to move on, or __Go back__ if you'd like to join an existing account instead of creating a new one.

![peoplegoal new account details](//images.ctfassets.net/6g4s9n00xmsl/6rA1s9Rj2hWgchfG7a4bzf/845c13f572a06fe964efb84d96969dc4/peoplegoal_new_account_details.png)

- Select your Role title and Organization size, then click __Next__ to move on or __Go back__ to change your new account name.

![peoplegoal new account role details](//images.ctfassets.net/6g4s9n00xmsl/1CrP8XXggWTbuvoyKNFjoR/ea2ef240cfd6ab149aeda3e03088d6b0/peoplegoal_new_account_role_details.png)

- You'll be asked to enter a new __subdomain__ to create your account. The subdomain is the unique URL for your organization on PeopleGoal. Employees can use the subdomain to search and request to join your account so try to make it as close to your business name as possible.

![peoplegoal new account subdomain](//images.ctfassets.net/6g4s9n00xmsl/6C3qhYyjADBKzr1cF1HtPj/0218a40130d336abfc1a2febf3905b2c/peoplegoal_new_account_subdomain.png)

- Click __Create your account__ and you're done!

<div id='invite-others-to-join-your-account'></div>

---

## Invite others to join your account

Invite teammates to collaborate on your [PeopleGoal](https://www.peoplegoal.com/product) account when you're getting set up or after you've created a new account.

__We'd recommend you add users to your account before you set up your teams and relationships structure__.

This will help to visualise how teams and relationships should connect using your actual employees, and give you the unique employee IDs to create those connections using the import templates for relationships and teams.

### 1. When you create your account

If you've got a few teammates in mind you can add them straight from the account set-up process.

- Enter their email addresses in the __Email__ section and click __Send invitation__.
- If you'd prefer to add team members after you've installed a couple of apps, click __I'm done, take me to my account!__ instead.

![peoplegoal invite users sign up](//images.ctfassets.net/6g4s9n00xmsl/58pACJYzAudaD4oeoQC7nl/f105af1d929c84798a26a182f7961136/peoplegoal_invite_users_sign_up.png)

### 2. After you've created an account

- Click the __Account__ menu in the lefthand navbar, then click on __Users__.

![peoplegoal account users menu](//images.ctfassets.net/6g4s9n00xmsl/33xcyIF5juWSiQ1G9k9Bne/dc261f5d8be92125f2d72dddbef30626/peoplegoal_account_users_menu.png)

- Click on the __Invitations__ tab and enter the email addresses of the teammates you'd like to invite.
- Click __Send invitation__ and we'll do the rest.

![peoplegoal invite users](//images.ctfassets.net/6g4s9n00xmsl/4s51snKRgbtxsUvs2QuMMA/078885e3310d3d82c5be87e5e9a6496e/peoplegoal_invite_users.png)

<div id='import-users'></div>

---

## Import users

You can add new teammates all at once by using the Import template.

- Click on the __Import users__ tab, then __Download import template__ to get started.
- Fill out the fields on your Excel template and save your local copy to upload this to PeopleGoal in the next step.
- On the __Import users__ tab, click __Next step__ to continue.
- Click __Select import data__ and choose your Import Template from where it's saved on your local machine.
- Click __Upload data__ and you'll see a new field appear in the __Data imports__ area.
- Click on the latest upload in __Data imports__ and choose which of your new profiles should be an Account owner (hint: not many!).
- Then click __Invite users__ and we'll send the invitation email to all of your new employees.

![peoplegoal import users](//images.ctfassets.net/6g4s9n00xmsl/7j6eHSBg1sN3DkDDX95QYC/811188d73f6df0541f01ebabb1471e48/peoplegoal_import_users.gif)

### Manage invitations you've sent

- Click on the __Invitations__ tab to see the status of the invitations you've sent.
- Click __Delete invitation__ to revoke access for anybody who hasn't yet signed up.

![peoplegoal delete user invitation](//images.ctfassets.net/6g4s9n00xmsl/6hFi8b3YxGXYQsQ3jJPFiJ/98394537914f399337ce7130662536d9/peoplegoal_delete_user_invitation.png)

<div id='join-an-account'></div>

---

## Join an account

Looking to join an existing PeopleGoal account? You can request an invitation.

- Go to [www.peoplegoal.com/sign-up](https://www.peoplegoal.com/sign-up) and click __Join an existing account__.
- Type in the unique subdomain for your organization and click __Send request__.

![peoplegoal join account request](//images.ctfassets.net/6g4s9n00xmsl/EaD5PEiwRdMJMUvneLEsG/ce91da079fa8fb4db9f70de9907f409d/peoplegoal_join_account_request.png)

We'll check if this business has a PeopleGoal account and if you already have an invitation pending.

When your request is successful you'll see a green "Done!" message and that's it. Your request will be sent to the account owners to approve, and you'll be notified by email of your approval with a login link.

---

After you've created or joined an account, you'll be taken to your new PeopleGoal Dashboard. [Let's take you through the easy navigation](https://www.peoplegoal.com/support/article/peoplegoal-account-navigation) and show you where to find your profile, workspaces, apps and teams.

Create a new account for your organization, invite your colleagues to join your team and manage requests to join the account.

Go to http://www.peoplegoal.com/setup and click "Create an account" or "Join an existing account" to set up a new PeopleGoal account.

How do I create a PeopleGoal account?

# Welcome to PeopleGoal!

This Getting Started guide will get any user up and running with apps, items and your PeopleGoal account. Learn how to set up your account, create a workspace and apps, and get your team started with a PeopleGoal Account.

For more advanced features and functionality, head over to the [Becoming a Pro](https://www.peoplegoal.com/support/category/become-a-pro) guide. Account owners can go to the [Administration and Account Management](https://www.peoplegoal.com/support/category/administration-and-account-management) guide to update account settings, create new relationships and manage teams.

---

## How Does PeopleGoal Work?

PeopleGoal is a __custom workflow builder__ for HR processes. PeopleGoal __apps__ are powerful forms that incorporate multiple participants. But we're not your traditional, static form builder! PeopleGoal apps move through many __states__ via custom triggers and actions. This allows you to easily execute complex HR processses that require input from lots of people.

Our apps can do (almost) anything! Whether you're looking for a [performance review with multiple managers](https://www.peoplegoal.com/support/article/how-to-run-a-review-with-multiple-managers), an [employee engagement survey](https://www.peoplegoal.com/support/article/how-to-run-an-employee-engagement-survey) that's adaptible to your industry standards, or an [absence management portal](https://www.peoplegoal.com/support/article/how-process-absence-requests-absence-management); we've got you covered with a huge store of ready-to-go templates. You're also free to adapt the app templates and design your very own processes from scratch. Every organization's HR needs are unique, and we're as configurable as possible to reflect that.

---

## Key Terminology

These are some of the key terms everybody will come across when using PeopleGoal.

__Apps__ are your processes / workflows - the core functionality of your account. In Performance Management for example, you'll have individual apps for reviews, one-to-one meetings, [360 feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) and OKRs/SMART goals. Or in our Development example below, you see apps for Training Approval, Development Plans and Career Development One-to-Ones. An app has a template for the form you want to complete which is completely customizable.

![peoplegoal apps](//images.ctfassets.net/6g4s9n00xmsl/7Ee2z5nisnprzGNj8yQOBj/1292c265fca411d9a11f3aca9cf14071/peoplegoal_apps.png)

__Items__ are an instance of an app created by a user. The performance review for employee Jane Smith is an item  created in the Reviews app, or your Q1 objectives will be individual items created in the OKRs app.

![peoplegoal items](//images.ctfassets.net/6g4s9n00xmsl/5I91tNEdWD0i0DAqhzYU2n/18961b4e6fa0c584cdb52e18cef19d26/peoplegoal_items.png)

__Workspaces__ are the containers for all of your apps. Think of it as the topic or category for all of the apps within a workspace, like Performance Management or Employee Engagement.

![peoplegoal workspaces](//images.ctfassets.net/6g4s9n00xmsl/sXLowZIwz3KbyjDBgGPPO/d289fe72eb40668274324474da14b0ce/peoplegoal_workspaces.png)

__States__ are stages in the app workflow. Every item can move through many states, with each state's participant being responsible for completing the form in that state and sending it on to the next state.

![peoplegoal states](//images.ctfassets.net/6g4s9n00xmsl/2XzPFjOm0SjP3AVoreDMeW/06804cd5698b1436086ba332503ce57f/peoplegoal_states.png)

__Permissions__ control the visibility of items, apps and workspaces. You'll see permissions like "create only", "create and edit" or "view only". Permissions can be configured right down to the app level, so you can have different workspace and app permissions.

![peoplegoal permissions](//images.ctfassets.net/6g4s9n00xmsl/5RocjpCpDa0b2p1nC413vG/b538458e2ebfcdb8056c3c225cf56d0d/peoplegoal_permissions.png)

__Relationships__ are a link between two users - like Manager/Direct Report, Supervisor/Employee or Mentor/Team Member. You can have many relationships on [PeopleGoal](https://www.peoplegoal.com/product), meaning you're not limited to the traditional employee/line manager views.

![peoplegoal relationships](//images.ctfassets.net/6g4s9n00xmsl/DZra0ByDP4bXIeSLXyEUg/98b94848217018833d4583a0cdaa7ef3/peoplegoal_relationships.png)

__Teams__ are groups of users. You can belong to many teams, and teams can connect to one another to build out a matrix organizational structure that reflects your actual working groups, not just a strict organizational hierarchy.

![peoplegoal teams](//images.ctfassets.net/6g4s9n00xmsl/4GtF0emkKOIz2qk4ktwghd/d041f995e3d324334e9c8c4b3742f192/peoplegoal_teams.png)

---

Got it? Let's get you started with [creating your PeopleGoal account](https://www.peoplegoal.com/support/article/create-a-peoplegoal-account).

Quick start guide to build a PeopleGoal account in a day

The PeopleGoal Getting Started guide will help you get to create a new account, set up your workflow apps and invite others to join your team.

PeopleGoal Guide to Getting Started

PeopleGoal Support Center - Getting Started

Getting Started

Quick start guide to create and navigate your new PeopleGoal account

Create a PeopleGoal Account

# How to process Absence Requests using the Absence Management app

__Absence requests are an important day to day HR responsibility. An organized, automated system will help avoid miscommunications. PeopleGoal's Absence Management app keeps HR, managers and employees in the loop about absence requests.__

The app is simple to use and entirely customizable to your company's policies. Why not get started, to ensure employees get the leave they need to do their job optimally?

<a href='#install'>1. Install the Absence Management App</a>

<a href='#customize'>2. Customize the Absence management app template</a>

<a href='#configure'>3. Configure the form states</a>

<a href='#manage'>4. Manage form participants</a>

<a href='#permissions'>5. Set up Absence Request app permissions</a>

<a href='#launch'>6. Send off your absence management request</a>

 <div id='install'></div>

---

## 1. Install the Absence Management app 

You can install the Absence Management app in any relevant workspace, from Culture to Development. Remember that you can add as many apps as you like to your PeopleGoal account! 

- Click on __Create a new app__ and then select __Store Template__. 
- Search for Absence Management and then press __Add this to your account__.
- Choose the workspace you want this app to belong to.
- Select __Install template__, wait a few moments, and you’re ready to use your new app!

![absence management install app](//images.ctfassets.net/6g4s9n00xmsl/4ywcKjhSR82kqXIFbeHC4L/b1105043ff586b321a21f7ba3085f89b/absence_management_install_app.gif)

We’ll take you directly to the app to get started. We have an Absence management Form Template up and running. If you don’t need to customize further, <a href='#manage'>skip ahead to Step 4</a>.  

<div id='customize'></div>

---

## 2. Customize the Absence management app template 

Your HR team may have a unique policy for absence management. With PeopleGoal’s app, you can make this as relevant as you need. 

To edit the form template, simply press the __Template menu__, then __Edit template__. 

![absence management request edit template](//images.ctfassets.net/6g4s9n00xmsl/4SbaD7hNpKepvkXK8kGAYk/a8637bb26460a617943a12145ab0cea6/absence_management_request_edit_template.png)

### i. Edit existing elements 

Elements are the individual __form fields__. It’s easy to edit this to be more relevant to your company’s policies. 

- Hover over the element to edit, click the three little dots that appear, then __edit element__.
- If you need to edit the form’s title or description, hover over the three little dots beside the title and then hit __Change section title__. 

Perhaps you want forms to indicate where employees are absent due to their mental health? To do this, press the three dots beside the drop-down menu and select __Edit select__. You can then add ‘mental health need’.

![absence management request edit element](//images.ctfassets.net/6g4s9n00xmsl/6l79H38OQ3ow9eEmMMcSeS/df5e24dc80746bd16fa8cfdb67981699/absence_management_request_edit_element.png)

### ii. Duplicate elements 

HR may ask more questions on the Absence request in order to understand the reasons behind absenteeism. If you would like to repeat the drop-down menu form from the first question, it’s easy to duplicate elements. 

- Hover over the three little dots next to the element and select __Duplicate element__.
- Select __edit select__ to change the question and drop-down options.
- Remember to __save changes__!

![absence management request duplicate element](//images.ctfassets.net/6g4s9n00xmsl/1ev3viL6DyKEKaTZwBLdco/b9a9f53139b45c03d90e7f8dfb49b328/absence_management_request_duplicate_element.png)

### iii. Re-ordering elements and sections 

You may want to rearrange the structure of the form. To re-order elements:

- Hover over the 6 little dots to the left-side of the element you want to move. 
- __Click and drag__ the element to wherever it works best on the form.

![absence management reorder element](//images.ctfassets.net/6g4s9n00xmsl/77Gk7OMhu2qRJxGs7HuG3/ab110b85a21840221ef7b88124dd6d62/absence_management_reorder_element.gif)

### iv. Create new elements and sections 

You may want to use the form as a chance to gain more insights into absence management at your organization.  For example, you may want to ask whether employees feel they have adequate leave to do their job optimally.  

- To add a new element, simply scroll to the end of the form and click __Add element__. 
- Select the element type you want to insert, whether that's a text input, calendar or slider. 

Sliders work well for measuring agreement or likelihood. You could ask employees to measure the statement *‘I feel that I have adequate leave to perform optimally and prevent burnout’* on a slider.

- Simply select __Add element__, then select __Numerical__, then __Slider__.
- You can edit the 'Name' of your slider. This is the statement you want to measure. 

![absence management request add element](//images.ctfassets.net/6g4s9n00xmsl/6nh6WoemHVPFRRRv60sVq6/26f6bd8bd138fc5781749c1d06843841/absence_management_request_add_element.png)

<div id='configure'></div>

---

## 3. Configure the form states 

Your form is all customized and almost ready to go. Now, choose who will see the form before it is passed back to HR. 

Above the form template is the __form’s workflow__. This identifies who interacts with your form, and at what stage of the process.  You can customize this as much as you want. 

Each square of the workflow is a __state__. Each state has its own __participant__. You may wish to add managers to this workflow, so that they can see any employee requests for absence. 

### i. Add a new state, e.g. a manager 

- To add a state, press the plus sign next to the workflow.
- Enter your state name, for example 'Department Head Approval' for the HOD to approve a request. 
- Type the name of the participant, and select a status flag (e.g. Completed, In progress).
- You can select whether you want all sections to be visible to this participant by default, and if you want participants in this state to be able to edit the form. Most likely, you will only want managers to be able to review the request by default. You may want managers to add comments to the form before it returns to HR.  
- With your new state added to the workflow, __click and drag__ each state to the order you need. 

![absence management add state](//images.ctfassets.net/6g4s9n00xmsl/22xiolgWldBPB3CNLQC2Sq/dde38be0b531a800dd6137b4363e71f4/absence_management_add_state.gif)

You may want to add an element that is __only visible to HR__. Select __add section__ and then __add element__ to create a text input for HR to provide some initial thoughts. This section can be invisible outside of HR. 

- To do this, select states outside of HR.
- Scroll down to this section and click the 3 dots on the right-hand side.
- Then select __Hide section in this state__.

![absence management hide section](//images.ctfassets.net/6g4s9n00xmsl/1usDD4RCHt7XZx3jEBeKrx/95173ffb70497b933d7b9e35f172842f/absence_management_hide_section.gif)

### ii. Delete a state

- You can delete a state by pressing __Template__, and then __Configure States__.
- Scroll down to __Delete State__ below the state you want to delete.

![absence management request delete state](//images.ctfassets.net/6g4s9n00xmsl/1Wv76ksfjmSiQxIN7JMJju/27982c70c1d6785fdc349eab65af2f93/absence_management_request_delete_state.png)

### iii. Customize status flags

You can make status flags more relevant to your company's language.

- Simply press __Template__, then __Configure states__.
- Then press __Manage status flags__. A grid will appear showing current status flags - you can edit them however you like!
- Remember to save changes.

![absence management request status flags](//images.ctfassets.net/6g4s9n00xmsl/3ldtt7KKriTnWLuDK63my4/cbc46d6458ea5e78129819299c28412d/absence_management_request_status_flags.png)

<div id='manage'></div>

---

## 4. Manage form participants 

Participants are the individuals involved in the absence request  - each state has one participant. To automate absence requests, you can set up default participants according to account [Relationships](https://www.peoplegoal.com/support/article/relationships). 

This means when an absence request comes through, the process of informing the employee's manager and the HR team can be automated. 

### i. Set default relationships and users

- Select the __Configure states__ menu and click __Manage participants__.
- For each participant, set a default user or default relationship to automate the Absence Request workflow.
- Participant names are customizable - so you can edit this to suit your company's language.

![absence management request participants](//images.ctfassets.net/6g4s9n00xmsl/1q4pPJqrA7FgnthvSurHxX/c3de128a8d4c5cb3c56b57192100c244/absence_management_request_participants.png)

### ii. Manage participant visibility

Not everything will be relevant to every participant - and absence requests can contain confidential information. You can select whether each participant has 'Full Visibility' or 'Limited Visibility'. 

For example, if HR adds comments at the end of the form, you may not want this to be visible to the employee making the absence request.

- To do this, press __Template__, then __Configure states__.
- Then hit __Manage participants__. A grid appears that is completely customizable - make changes to names and visibility.

![mood surveys visibility](//images.ctfassets.net/6g4s9n00xmsl/4zQn2vq1rGfQcMl7Fia8xK/7b3c2e751b68c520a35fba5e85ef4840/mood_surveys_visibility.png)

<div id='permissions'></div>

---

## 5. Set up Absence Request app permissions 

Permissions control who can access the Absence Requests app in your PeopleGoal account. This determines who can __create, edit and/or view__ all of the Absence Request forms.

- Click on the __Settings__ menu, then select __Permissions__.
- Select __Explain permission types__ - these will explain what access the different permissions provide.

![absence management request permissions explained](//images.ctfassets.net/6g4s9n00xmsl/4hJDQFhuG1o7DjycI9GN0X/0f4a45b69aaaab5bf1233fdb642ee441/absence_management_request_permissions_explained.png)

### i. Set up app-wide permissions

For Absence Requests, we reccommend you set the permission to __Create only__. This means employees can create absence requests when they need to, but can't see the requests of other employees.

### ii. Specific team and user permissions

Maybe there are certain individuals you would like the forms to be visible to, for example team managers. HR may even want managers to be able to edit absence requests with their own comments.

The person who installed the app has __Owner permission__ by default. They can assign different permissions to users. These specific team and user permissions overwrite the default permission type.

- To do this, select __Configure specific permissions__ under __Permissions__ in the Settings menu.
- Use __relationship permissions__ to allow a relationship type Create, View and Edit permissions just for their subordinates.
- Under __user permissions__, click __add user__.
- Search for your colleague's name and add them to the permissions list.
- You can then select which level of permission to give them, under the 'Permission type' column.

You might consider giving your leadership team 'Create and View' permissions, so they can see all absence requests but cannot edit app states or the template.

![absence management request permissions](//images.ctfassets.net/6g4s9n00xmsl/6akW3HUdnwvOCY0mD3DJKn/24dd328ffaf508b3165a68720d4bd16c/absence_management_request_permissions.png)

<div id='launch'></div>

---

## 6. Send off your absence management request 

All that's left to do now is to send off the absence request form to employees!

- Simply select __New absence request__.
- To complete an absence request for yourself, select your own name.
- Or, for an individual employee, click __Select user__ and search for their name.

If you want to inform entire teams about the absence request form, so they know where to go when they need it - you can launch the form for __entire teams__.

- Select __New absence request__ and then click __Select teams of users__.
- Then search for the team you want to send the form to.

![absence management request launch](//images.ctfassets.net/6g4s9n00xmsl/7mgwp5qj9uu423l1iDgBVJ/7a2bb6ec42fcaf2c806ff362325816f2/absence_management_request_launch.png)

## Tackling absenteeism: Make the most of PeopleGoal analytics

[PeopleGoal](https://www.peoplegoal.com/product) captures every data point of your company's absence request, so that you can track the absenteeism and wellbeing of your employees.

Our [Reports building article](https://www.peoplegoal.com/support/article/reports) will teach you how to make the most of this quantitative data - so that you can start creating evidence-based strategies for your people.

Why not try the PeopleGoal's [Employee Wellbeing Survey](https://www.peoplegoal.com/app-store/template/employee-wellbeing-survey), which can pinpoint the root causes of absenteeism? Find even more resources in our [App Store](https://www.peoplegoal.com/app-store).

New to PeopleGoal? [Book a demo](https://www.peoplegoal.com/book-a-demo) to see our Absence Management app and other HR workflows in action.

Absence management can be an admin-heavy task. With PeopleGoal's Absence Management app, you can ensure requests are processed efficiently and customize the form to your company's culture.

Use our simple absence request app to easily create a self-service absence management portal for employees.

How to set up an Absence Request process for employees

Use our simple app to easily create a self-service absence management portal for employees

How to process Absence Requests through the Absence Management App

# Relationships

__Relationships are connections between users on PeopleGoal. A typical relationship will be a Manager and a Direct Report. You can have many different relationships, helping to define your custom workflows and visibility options. Account owners will start by defining the relationship types you want to include, then assign specific relationships to all users.__

To view your relationships, click the __Account__ icon in the lefthand navbar, then click __Relationships__.

![peoplegoal reviews matrix organisation](//images.ctfassets.net/6g4s9n00xmsl/5rBf2fpBqabHX0XBIw2sJU/5614269fec390c56562bce0ea984418a/peoplegoal_reviews_matrix_organisation.png)

---

## Create relationships

Before you start building your workflows it's helpful to have your key relationships defined. Don't worry - you can return to the __Relationships__ menu to update these at any time.

- Click the __Create a new relationship__ button to define your relationship type.
- You'll be asked to list the supervisor (upper level) and the subordinate counterpart (lower level) titles - for instance, Manager and Direct Report. You should also enter a Relationship description. This helps to designate between reporting lines, for instance where a supervisor is a dotted line report rather than a direct manager of an employee.

![peoplegoal profile relationships](//images.ctfassets.net/6g4s9n00xmsl/EJ6XILWHCz67PoXpRY0Vw/3af4d137bb4f4adb878509f164910abc/peoplegoal_profile_relationships.png)

---

## Assign relationships individually

On the relationships view, all employees are shown. At the top of the view you'll need to select the relationship type from the drop-down list to ensure you're assigning the correct relationships to your users.

- Zoom in or click __find a user__ to work with one individual, then double click their profile image to set their relationship.
- Both the supervisor and subordinate fields are visible here, so you can define an employee's manager at the same time that you set up that employee's own direct reports.
- Click in the field to search for your other users, then click __Set relationships__ to save.
- To move on to the next relationship type, select it from the drop-down list and follow the same steps.

---

## Import relationships in bulk

When you're working with a big group it's much easier to define all relationships at once, using the Import Template.

### Download and complete the import relationships template

- Once you've created your relationship types, click __Import relationships__.
- Click __Download import template__ to generate your unique .xls file.
- The file has three tabs: your Import Template, a Relationship Data and a User Data tab. Every field on [PeopleGoal](https://www.peoplegoal.com/product) has a unique ID which allows you to connect your data in endless combinations, and you'll use these IDs anytime you're managing a data import.
- Click on the first __Import Template__ tab and copy over:
- The Relationship ID (from the Relationship Data tab) for the relationship type you want to assign. This is the supervisor field - e.g. the Manager in a Manager/Direct Report relationship.
- The User ID (from the User Data tab) for the supervisor.
- The Counterpart User ID (from the User Data tab) for the subordinate(s).
- Of course, managers will generally have multiple direct reports, so make sure you repeat the same Relationship ID and User ID for each relevant Counterpart ID field.
- Save your file to your local machine once you're done, then head back to PeopleGoal and click __Next step__.

### Upload your import template

- Click __Select import data__ to choose your saved file, then __Upload data__.
- The upload is saved to the __Data imports__ list, and you can see the status of your import here.

### Manage your imports

The import status will read:
- Complete (green): import was successfully uploaded
- Part complete (amber): import was successfully uploaded but with errors
- Failed (red): import was not successfully uploaded

Click on an import listing to upload the full details and view any errors.

You'll need to check that you've structured your .xls file correctly, and you can take a look at Data import troubleshooting here.

You can also roll back to a previous version of your Relationships structure if needed. Click the __Roll back import__ button and your selected import will be deleted, and we'll restore the previous structure.

The status of your import will change to "Rolled back" (gray).

Relationships are connections between users on PeopleGoal. We'll explain in more detail how to create and update relationships for your full account.

Relationships can be created by account owners. Click the Settings icon in your navbar, then relationships. Double click a user to change their relationships.

How do I create a relationship on PeopleGoal?

Relationships

Apps are your workflows that employees will interact with. Learn how to create custom apps that automate complex, multi-step HR processes.

Create custom apps that automate complex, multi-step HR processes. Open up your workspace, then click "Create a new app" and select "Blank template".

How do I create a PeopleGoal app?

Apps

# How to Create an Employee Asset Tracking process

__For many of us, we fail to achieve even the simple task of keeping track of our phone, wallet and any other possessions. That [chilling sensation](https://www.peoplegoal.com/blog/psychological-safety) that courses through your body when something you need isn't exactly where it's supposed to be, is something no one would ever choose to experience. An antidote to this may well be impeccable organizational skills, however, not even the most well-organized individual can prepare for the intervention of another person. Someone who may, unbeknownst to them, pick up an item and leave it elsewhere, in their own search for whatever they can't find can inadvertenly cause havoc for another individual.__

Whilst it may seem that this [frustrating cycle](https://www.peoplegoal.com/blog/work-burnout) of finding and losing things is never-ending, there is a solution. At PeopleGoal we have created an [asset tracking app](https://www.peoplegoal.com/app-store/template/asset-tracking) that allows for all employees to update and maintain a constant inventory of all of your company assets in real-time. Using an asset tracking system is a great solution for any organization. By shifting the responsibility from the employees to a centralized electronic system you can expect to have considerably fewer issues with tracking assets and your inventory management would no longer be prone to the unpredictability of human error.

Asset tracking provides valuable insights into the performance of your organization's physical spaces and materials. Developing a greater [appreciation](https://www.peoplegoal.com/blog/5-sample-letters-of-appreciation-for-employees) for the use of inventory tracking will have significant benefits in identifying and conceptualizing important factors that can enable you to harness much more streamlined and efficient business operations. In other words, asset tracking can provide you with terrific insights that will allow you to get the most out of your organization.

An analysis of your organization's asset [utilization](https://www.peoplegoal.com/blog/job-enrichment-to-improve-employee-engagement) can contribute to other benefits. For example, through the use of such software, you can expect to make significant cost savings. Items suspected to be lost can be more easily traced and therefore discovered. Additionally, by monitoring the rate of use of particular items or machinery, you can optimize your organization's budget. With an asset tracking system in place, you are more able to establish the most crucial items of stock in contrast to the least important or even unnecessary equipment. This also applies to equipment maintenance too, ensuring that employees are safe when conducting operations with particular tools.

If you would like to improve the electronic structure of your asset tracking system with [PeopleGoal](https://www.peoplegoal.com/product) then take a look through this guide to learn more about how you can set up an employee asset tracking process with our pre-built app.

Following the steps below, install and launch an employee asset tracking process in a matter of minutes:

<a href="#install">1. Install your Asset Tracking app</a>

<a href="#customize">2. Customize the app template (optional)</a>

<a href="#configure">3. Configure the app states (optional)</a>

<a href="#manage">4. Manage your app participants and permissions</a>

<a href="#reports">5. Create your reports</a>

<a href="#launch">6. Launch your Asset Tracking app!</a>

<div id="#install"></div>

---

## 1. Install the Asset Tracking App

- Open up any workspace, click __Create a new app__, then select __Store template__.
- Select the *Asset Tracking* app and click __Add this to your account__.
- Select the workspace (and workspace folder) you want this app to belong to from the drop-down menu, then click __Install template__.

We'll take a few seconds to add this to your account, and you'll be taken straight to the app to get started.

![asset tracking install app](//images.ctfassets.net/6g4s9n00xmsl/36v8CBIs6ax5ukmPnqzYqW/5b0492b78659cfc0d8533d722b62ff7d/asset_tracking_install_app.gif)

All of the pre-built tracking form questions and states are installed and ready to go. You can use the app right out of the box! To skip the customization, <a href="#manage">head on down to step 4</a> and set up your app participants and permissions.

<div id="#customize"></div>

---

## 2. Customize the Asset Tracking App Template

If you would like to configure the asset tracking form to add your own questions and states, click the __Template__ menu, then __Edit template__.

![asset tracking edit template](//images.ctfassets.net/6g4s9n00xmsl/7oFHIH5r8GQbqSBHLYvoPo/dc686e790d6cb2953eeaa8dad41b7dae/asset_tracking_edit_template.png)

### i. Edit existing elements

Elements are your individual form fields that make up your tracking form. Whether they're text questions, drop-down menus, display-only fields or numerical calculations, every element can be changed to suit your custom process.

- To change a field, hover over the right-hand side of the element and click the three dots that appear.
- Select __Edit element__ (your element will have a name like "Select", "Description", "text area", etc.). The element editor will open up.
- Change any fields you need to and click __Save changes__ to update.

![asset tracking duplicate element](//images.ctfassets.net/6g4s9n00xmsl/4LE5b5VBlASbCAe9HjYgQV/0c368e9066c6686b269e11a65e7d0a51/asset_tracking_duplicate_element.png)

You should note that each element is unique, so if for example you change the rating set on one element you'll need to change any other questions to match this. Don't worry, it's quick and easy to duplicate an element once you're happy with its setup. 

### ii. Duplicate elements

- Hover over the right-hand side of the element and click the three dots that appear.
- Select __Duplicate element__ and an exact copy will be created below.
- Edit the duplicated element to change your question text.

### iii. Reorder elements and sections

Reordering is super easy - you just click and drag to change the element or section order.

- Hover over the left-hand side of the element (or section title) and click and drag your element or section to its new location.
- To move an element to a different section, hover over the right-hand side and click the three dots that appear.
- Select __Change section__ and choose the new section you want the element to belong to.

![asset tracking change section](//images.ctfassets.net/6g4s9n00xmsl/U3CkC8MF10uu2ZRc6N9XI/c734e305218fba4769751c397aef5d5b/asset_tracking_change_section.png)

### iv. Create new elements and sections

- At the bottom of each section, click __Add element__ and select the element type you want to insert.

A new element that's useful to add to your first section is a display-only Description or Rich-text area. You can use this to detail the asset tracking process and explain exactly what's included.

To add a new section, scroll to the very bottom of your template form and click Add section. Then click and drag your new section to where you want it to sit in the survey flow.

- In the example, we add a section with a calendar element. This calendar will prompt employees to provide an estimate for the period of time that they intend to use an asset.

![asset tracking add element](//images.ctfassets.net/6g4s9n00xmsl/2PorFsAmMOXWwT0w36mUPs/637af58ffa863e7aee53aab24e2c9aa5/asset_tracking_add_element.png)

<div id="#configure"></div>

---

## 3. Configure the Asset Tracking App States

States are the steps in your Asset Tracking workflow, and each state has its own participant. The Request New Asset is one state and the Asset Requestor is the participant - likewise with the Asset Manager and Asset Holder recording and confirmation states.

There's no limit to the number of states you can add to your survey workflow. What's more, you can select whether each state is read-only, editable or hidden to the selected state participant.

### i. Add a new state

- Click the __+__ button in your workflow builder to create a new state.
- Enter your state name, define the participant, and choose a status flag.
- Toggle on/off whether sections are visible or editable by default (don't worry - you can override this later if you need to).
- Click and drag your state to reorder your tracking form workflow and you're done!

See how we add in a new state for *Asset Maintenance* for the Asset Manager. The purpose of this final state will be to ensure that the relevant checks are made by the Asset Manager once the Asset Requestor has finished using the asset. We will also need to include a new section below Asset Details, named Asset Condition. This section is can only be edited by the Asset Manager so we'll make it read-only in the other states. Here the Asset Manager can update the others on the condition of the asset and if there is any new damage or if any repairs are necessary.

![asset tracking add state](//images.ctfassets.net/6g4s9n00xmsl/YNTg259P2OIrt94krmrhJ/62e95282f33421cd553b1ad9b4f09345/asset_tracking_add_state.gif)

### ii. Delete a state

- To take out a state you won't be using, click the __Template__ tab and select __Configure states__.
- Select the state you want to delete and you'll see the blue highlight bar appear to confirm which state you've selected.
- Click __Delete state__ to remove it completely.

![asset tracking delete state](//images.ctfassets.net/6g4s9n00xmsl/Eiaq0EiicAMDjSLWmDJo7/4303b6a32ed3f9b0a93c5e20d14a6eed/asset_tracking_delete_state.png)

### iii. Customize your status flags

Every state has a default status flag that indicates to all participants what stage of the process their item is in. Your Asset Tracking app is set up with default status flags which you can customize.

- In the __Configure states__ menu, click on __Manage status flags__.
- Click a flag title to rename it, and click the color picker to choose a new flag color.
- Click __Create a new status flag__ to add an additional flag.
- Select the state to which you want to assign your flag, choose which flag to give it and click __Save changes__ to update.

![asset tracking status flags](//images.ctfassets.net/6g4s9n00xmsl/YrwRqKsDjHbJ0T7ElCs0g/710b64e014a471d8df728c41cd370c00/asset_tracking_status_flags.png)

We recommend that you delete any unused status flags so that they don't clutter up your Item filter once you've launched your tracking forms. You may want to alter the colors of your flags or as we've done create a new status flag titled "Awaiting Approval" for when the form is between states for approval.

<div id="#manage"></div>

---

## 4. Manage your Asset Tracking App Participant and Permissions

Participants are the individuals involved in the Asset Tracking form and each state has one participant. To automate your Asset Tracking process you can create default participants based on your account [Relationships](https://www.peoplegoal.com/support/article/relationships), define an individual as the state participant, or leave these blank to allow the employee to select all participants when they come to fill in the form.

Setting up your participants based on relationships means that when an employee creates a new form, all of the people who need to be involved in the workflow are automatically assigned.

### i. Set default relationships and users

- Open up the __Configure states__ menu and select __Manage participants__.
- For each participant set a default user or default relationship to automate the tracking form workflow.
- You can also rename the participants to suit your company language.

In our example, we have designated the default user for the Asset Manager role to Chet Hirthe, as they are going to be responsible for all of the assets in our company. This way whenever an employee makes a request for any company assets, they will be notified.

![asset tracking participants](//images.ctfassets.net/6g4s9n00xmsl/71GRI16zUjtQ8bFXbe6ZVB/d505892aa22edce545ffc79d67082ab9/asset_tracking_participants.png)

### ii. Define the participant's visbility

If you have lots of different participants you need to control who can see the data at every step. Visibility defines whether a participant can see the review only in the state that they own (limited visibility), or in all states (full visibility).

By default participants can only see the form when it's in a state that they own. For Asset Tracking, all participants should have full visibility because we want them to see the discussion and comments mad by all involved in assigning assets before they are officially released. The employee will see the form in the first and last state - when they draft their request and again when it comes back to them for the final confirmation. These are the states where the employee is the participant.

The asset manager and holder will also both have full visibility over the whole process - even when they're not directly participating.

- To change a visibility level, click the drop-down next to the participant name and choose Limited or Full visibility.
- Click __Save changes__ to lock in your updates.

![asset tracking visibility](//images.ctfassets.net/6g4s9n00xmsl/3vrIPBkf5yZXBvFZu85up8/4f76794e3917c1825b624406384e4864/asset_tracking_visibility.png)

### iii. App-wide permissions

Permissions control the access to your app within your PeopleGoal account.

- To set your permissions, click on the __Settings__ menu, then expand the __Permissions__ section.
- Click on *Explain permission types* to understand the access that each permission gives your account users.

![asset tracking permissions](//images.ctfassets.net/6g4s9n00xmsl/1qTucG2GZ7IdAohIfc0XKw/0f910efc41e8ffab8c5eae5391132972/asset_tracking_permissions.png)

In your Asset Tracking form, we'd recommend you set the permission to Create only. This means employees can create forms for themselves but can't see any colleagues' forms since this isn't really necessary and prevents confusion.

### ii. Specific team and user permissions

The user who installed the Asset Tracking app template has __Owner__ permission by default and can assign specific permissions to other teams or users. Specific team and user permissions replace the default permission type.

- To assign a specific permission, select __Configure specific permissions__, then under "User permissions" click __Add user__.
- Type your colleague's name to add them to the permissions list. In the "Permission type" column, select which permission level to give them.

You might want to give "Create and view" permission to your C-Suite so that they can oversee the status/ omments for all Asset Tracking forms but without being able to change the app settings or edit forms they're not a participant in.

![asset tracking permissions specific](//images.ctfassets.net/6g4s9n00xmsl/33aPlcj8Pxjpg3NJNLuqsB/4426224d9efbcc123acf509b2dea4aa9/asset_tracking_permissions_specific.png)

<div id="#reports"></div>

---

## 5. Creating Reports

Every single data point entered in apps from PeopleGoal are collated and can be used in data analysis. To see the data at work, jump over to the __Data__ tab and marvel at the wonders of the numbers.

From here you can sort and filter any categories you like. Whether you want to know what the most requested asset is or the time at a certain time of the month that assets are most in-demand, you can play around with the various charts and responses to determine what matters the most to your company. This tool is really powerful and can make a difference in optimizing how your company uses all of its assets. Analyzing the activities and demand for particular assets can reveal a lot about how you may want to distribute assets amongst team members.

The options are limitless... well as limitless as your form's questions but you get the point. [Check out our Reports building article](https://www.peoplegoal.com/support/article/reports) to learn how to create custom reports and charts.

<div id="#launch"></div>

---

## 6. Launch your Asset Tracking Forms!

There you have it, your Asset Tracking Process is all set and good to go! All you need to do now is invite your employees to start making New Asset Requests. You are able to create and assign these yourself or have users make their own as and when they need to.

- To create a new form, select __New Asset Request__ and then select the participant(s).
- To start a form for yourself select your own name.
- To start forms for multiple individuals, click __Select user(s)__ and search for individual employee names.
- Or, click __Select team(s) of users__ and you can kick off forms for entire user groups!

![asset tracking launch](//images.ctfassets.net/6g4s9n00xmsl/4M5GRmEBsqXhC5iCiavgWy/93b20d11ab2f3d7fce3c98428b8c7e9c/asset_tracking_launch.png)

---

Having got your Asset Tracking Forms built and customized to your needs, take some time to explore the other apps you can install within your [HRIS workspace](https://www.peoplegoal.com/app-store/template/hris-8b9552c1-7175-4695-916a-5106d098d9f3). We recommend implementing [Time Tracking](https://www.peoplegoal.com/app-store/template/time-tracking) to maintain a better understanding of the hours worked by all employees, along with a record of the tasks they performed each day. Moreover, [Absence Management](https://www.peoplegoal.com/app-store/template/absence-management) can be really useful to monitor the amount of holidays employees have left or for tracking individuals on sick leave. You'll find these and more in our [App Store](https://www.peoplegoal.com/app-store).

Don't have a PeopleGoal account yet? [Book a demo](https://www.peoplegoal.com/book-a-demo) to see our no-code [HR workflow](https://www.peoplegoal.com/blog/workflow-examples) builder in action!

Streamline your asset and inventory tracking with PeopleGoal's easy to install app template.

How to Create an Asset Tracking sheet

How to create an employee Asset Tracking process

# Navigating PeopleGoal

__Your PeopleGoal account has a simple structure on the surface, with a lot of powerful workflow features behind the scenes. To get started you'll find everything you need in the lefthand navigation bar. Clicking each icon will bring up an area of your account.__

![peoplegoal dashboard](//images.ctfassets.net/6g4s9n00xmsl/7AwjFHe4a3WIqSWctdjcuj/9fc16501b103aabc2e9b7721e6db9867/peoplegoal_dashboard.png)

Jump straight to:

- <a href='#your-account'>Your Account</a>
- <a href='#dashboard'>Dashboard</a>
- <a href='#workspaces'>Workspaces</a>
- <a href='#teams'>Teams</a>
- <a href='#reports'>Reports</a>
- <a href='#account'>Account</a>
- <a href='#notifications'>Notifications</a>
- <a href='#user-menu'>User Menu</a>

<div id='your-account'></div>

---

## Your Account

You can belong to as many PeopleGoal accounts as you'd like. 

- The Account icon in the top left shows the current account you're on. Click here to switch between your accounts.
- Click __Add an account__ to create a new account.

![peoplegoal add an account](//images.ctfassets.net/6g4s9n00xmsl/1GBlqx1sGaHol8mt1HvZ0B/d571010a571f7b4276d59c462697b46d/peoplegoal_add_an_account.png)

Each account will have its own subscription, so unless you're overseeing multiple regions with their own separate processes and billing, it's best to invite everyone in your organization to join one account. You can control access to apps by creating Workspaces for each region.

<div id='dashboard'></div>

---

## Dashboard

The Dashboard is your account homepage and has a summary of all of the items and tasks you own, as well as your teams and relationships.

![peoplegoal dashboard](//images.ctfassets.net/6g4s9n00xmsl/5H7MRUe0ztV9zSUmZFjSu5/046a103d12560c415c6e40e08bd83b24/peoplegoal_dashboard.png)

- The __To-do__ list will show all of the items that you currently own. You can see the status of each item in the bottom of the item tile. Click on an item to open it up and complete any outstanding tasks.
- Under the to-dos you'll find your __Company news__. This is an aggregated feed of posts from your teams, apps and workspaces.
- On the lefthand side you'll see the Search bar. Type here to search for other account users and view their PeopleGoal profile.
- Underneath the Search are all the __Teams__ you belong to. Click on a team name to open up the Team homepage.
- Under teams, you'll find your account default relationship (this is usually Manager, Supervisor or Team Lead). Click on a username to view all items belonging to this user (you'll only see items that you have permission to view!)

<div id='workspaces'></div>

---

## Workspaces

The Workspaces tab will show all of the workspaces in which you're a member.

- Click the Workspace tile to view all the apps it contains.
- Your recently-used workspaces will also show up as icons on the lefthand navbar with a pop-up list of your commonly-used apps.
- Click on an app title here to get quick access.

![peoplegoal workspaces](//images.ctfassets.net/6g4s9n00xmsl/1Zby2ja5oQXNQJZqjpHUVr/aebb545803673b486b278d582a55adeb/peoplegoal_workspaces.png)

<div id='teams'></div>

---

## Teams

Teams are the groups that all users belong to.

- Clicking __Teams__ will bring up the full organizational structure for you to view, create a new team or search for a team.
- The __List view__ shows an alphabetical list of all teams. Click the arrows to expand details, and click the team name to view all details and team members.
- The __Network view__ shows how your teams connect to one another. Double click the team icon to go to the full team details and view its team members.

![peoplegoal teams](//images.ctfassets.net/6g4s9n00xmsl/4g1hBAnjhBxIl1S9EcBDei/cdae1cca997b7909dca4b7509d3b2bb3/peoplegoal_teams.png)

<div id='reports'></div>

---

## Reports

This is where you'll find the custom reports that you've built using the workspace, app and item data.

All fields on [PeopleGoal](https://www.peoplegoal.com/product) have a unique ID, allowing you to connect data in endless combinations to build amazing reports targeted at exactly what you need to measure.

![peoplegoal reports](//images.ctfassets.net/6g4s9n00xmsl/1z0aHDHwpENxWQcW0jyehB/10f75028a54a24b564ffc89fc85b2ef4/peoplegoal_reports.png)

<div id='account'></div>

---

## Account

This menu is for Account owners only. The Account menu will allow you to manage relationships, users and settings for the whole account.

![peoplegoal account menu](//images.ctfassets.net/6g4s9n00xmsl/62WBE4yvnqxUoqvECnmszO/f24a8d094feb1bc296cbdb5f20bba3f9/peoplegoal_account_menu.png)

Learn more in the [Admin & Management](https://www.peoplegoal.com/support/category/administration-and-account-management) section of our Support Center.

<div id='notifications'></div>

---

## Notifications

This contains all of the in-app and email notifications you'll receive on your PeopleGoal profile, for all the accounts in which you're a member.

- Click a notification to open up the item it relates to.
- Click __Mark all as read__ to dismiss all notifications, or click __See all notifications__ to view your full notification history.

![peoplegoal notifications menu](//images.ctfassets.net/6g4s9n00xmsl/6UG9H47p4ooyz7vWtiUOC7/2c1be79b133eea47e515f0d33bdaa0aa/peoplegoal_notifications_menu.png)

<div id='user-menu'></div>

---

## User Menu

Click your profile image to open up your personal User Menu. Here you can view and update your profile, get in touch with our Support team or sign out of your PeopleGoal account.

![peoplegoal user menu](//images.ctfassets.net/6g4s9n00xmsl/5kKGQ6dnvmIlT2WHTOEOFw/a27093cc472d01068adc838136dc9782/peoplegoal_user_menu.png)

---

Now that you know how to get around, let's get some data in your account! The first thing to do is [install a Workspace](https://www.peoplegoal.com/support/article/install-a-workspace).

Get to know your PeopleGoal account, understand the navigation bar and where to find your workspaces, apps and notifications.

All of your PeopleGoal account details are easy to find in the lefthand navbar. You'll find your apps, teams, relationships and profile details here.

How do I navigate my PeopleGoal account?

Navigating PeopleGoal

# Option Elements

__Option elements are used when your participants need to select their answers from a pre-built list, or select from your users, teams, and items. They can be applied in so many use cases, though most often get used for ratings, both numerical and conditional (Likert-scale questions).__

There are five option elements:

- <a href='#select'>Select</a>
- <a href='#grid'>Grid</a>
- <a href='#user'>User select</a>
- <a href='#team'>Team select</a>
- <a href='#item'>Item select</a>

<div id='#select'></div>

---

## Select

Select options allow participants to select their response from a drop-down menu or list. They're most commonly used for ratings, but can also be used for multiple choice questions.

![option select](//images.ctfassets.net/6g4s9n00xmsl/2Vwo2jfEjaaqrr9MexB9lZ/3d2e11475b1c16a4640a38fdd406b963/option_select.png)

When editing a select element, you can choose 'Single choice' or 'Multiple choice' as your option type. You can also select 'Dropdown' or 'List' as the display type - generally, the list display is easier to use for multiple choice responses where participants may not know what the full list of options is.

Each option gets a unique name and color (select the color field to pick a new color). For ratings, you should also assign a number value to each option. These are used in your [Reports](https://www.peoplegoal.com/support/article/reports) and in any calculations (more on calculated elements below). Some of the applications of select options are:

__Review and Feedback ratings__

Having a custom rating set - with your own scale and descriptions - is a key part of creating meaningful, relevant reviews and feedback across teams. Whether you're using Exceeds/Meets/Below Expectations or a 1-5 scale, the select option allows you to easily create and duplicate a rating set within your apps. You can also include as many different rating types as you need within one form, because each rating is its own unique element on the template.

![option grid rating](//images.ctfassets.net/6g4s9n00xmsl/4912HL4Pqs5KB0tYfThJxq/2f350003829d4c3812b428415fc32df3/option_grid_rating.png)

__Diversity & Inclusion metrics__

When running a D&I or Engagement survey, it's important to protect the anonymity of participants. Open-ended text questions could give away too much info about the respondent and make your data difficult to compare. A multiple choice select element means you can define specific areas to measure, and let respondents pick any or all of the responses that suit them best.

![option multiple select diversity](//images.ctfassets.net/6g4s9n00xmsl/32LHL7rA8NF2DmesvJFMFr/7b7a1d81b8a2f855702793b7f3c654a3/option_multiple_select_diversity.png)

<div id='#grid'></div>

---

### Grid

The grid element is great for bundling ratings together and being able to easily select a response for each row. When setting up a grid element you define your column and row names, and include a number value for each column to help with reporting and calculations. You can add as many rows and columns as you need depending on the data you're capturing.

When selecting a display type, be aware that the Radio buttons are used for single-choice responses and the Checkbox buttons for multiple choice answers.

![option grid](//images.ctfassets.net/6g4s9n00xmsl/6eizcdL4XsfmQbOc0arAA1/7b28791bc39b46d7d87bfd0dc7db8cd3/option_grid.png)

__Competency ratings__

Core competencies are often used in a peformance review or 360 degree [feedback process](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide). Respondents rate the demonstration of competencies along a pre-defined scale (from 1-5 or Poor to Excellent), and the grid element allows participants to easily provide a rating for each competency without having to click multiple drop-down select ratings.

![option grid feedback](//images.ctfassets.net/6g4s9n00xmsl/2Vm3htTJVv7USjJvRVYKcc/7ee125e7629537380a1ef1ec48d6ea92/option_grid_feedback.png)

__Onboarding Checklists__

There are many participants in a new hire's onboarding process, and lots of different checkpoints along the way. A grid element will help to get a clear picture of what's in progress and what still needs to be done along the way.

![option grid onboarding](//images.ctfassets.net/6g4s9n00xmsl/4Fg8FJEEWjKDzzWX5RthWD/32da418e715a6f457836c767dd6c4f2c/option_grid_onboarding.png)

<div id='#user'></div>

---

### User select

The user select element allows participants to select one or many other users in your [PeopleGoal](https://www.peoplegoal.com/product) account when referring to other people within their app workflows. Note that the person tagged won't be notified that they've been selected, allowing you to reference other users in a completely confidential way. The users to select are generated from your account user list, so you'll be able to select any colleague on the samee PeopleGoal account. When you're setting up a user select element you'll need to select whether the response is single choice or multiple choice.

![option user select](//images.ctfassets.net/6g4s9n00xmsl/6W2oRJ1jwBTTKIyclOzuqi/540d9bbbc64a51ec9830d59638597e35/option_user_select.png)

__360 Feedback__

[360 feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) is often asked for confidentially by an employee's line manager. To keep these responses confidential, you don't have to include the Employee as a participant in the app workflow. Simply set the line manager as the first participant, and use the user select option to indicate who this feedback request will be about. Because the users tagged are not notified in any way, this feedback is completely confidential between the provider and the line manager.

![option user select feedback](//images.ctfassets.net/6g4s9n00xmsl/56U6bQXb2YbwUNIpchRK9i/953c340e3acbbbc3703fe38fa122ce29/option_user_select_feedback.png)

__New Joiner Survey__

A [new joiner survey](https://www.peoplegoal.com/app-store/template/new-joiner-survey) is a crucial point in the [onboarding process](https://www.peoplegoal.com/blog/5-key-employee-onboarding-process-steps-to-master), where you can guage how your new talent is settling in and if there are any areas they need more help. Another great question to ask is whether anyone in the company has gone above and beyond in their onboarding, or if there's anyone else they'd like to get to know better.

![option user select new hire](//images.ctfassets.net/6g4s9n00xmsl/Asq922Th295Qxl4oBF2Qs/fabd073b5c90310f12eceaac2b43e39e/option_user_select_new_hire.png)

<div id='#team'></div>

---

### Team select

Similar to the user select, the Team select element asks participants to select one or many of the account teams from a drop-down list. Team members are not notified, but this is a useful field to include in your app reporting and item management.

![option team select](//images.ctfassets.net/6g4s9n00xmsl/4UOOQNdhYMIE9Wl5Ehgw8p/ddc5989fc299ddb562d2e08098a3a12d/option_team_select.png)

__Team OKRs__

When setting up team and department OKRs, use the team select option to indicate which team(s) will be contributing to this OKR. You can then include the Team field in the App overview so that all employees can see at a quick glance which team is responsible for the OKRs listed. This is also useful for cross-functional working, where you can select multiple teams from the drop-down list and report on how various teams work together on achieving the business targets.

![option team select okrs](//images.ctfassets.net/6g4s9n00xmsl/3Ct37O4n8sCpsSCfslssdz/740acf53bdd910d3cbcd880c330b9d61/option_team_select_okrs.png)

__Asset Tracking__

Generally asset tracking is used on an individual basis, but there are some cases where a team will have shared use of an asset in your company. The Asset Manager can use the team select option to indicate which team is taking ownership of this asset, and easily follow up with any team members on the asset's condition and whereabouts.

![option team select asseets](//images.ctfassets.net/6g4s9n00xmsl/6PoIGp1ZhxHOkukUMv9ACN/7b13461495f34e99cd5137efeb387d40/option_team_select_asseets.png)

<div id='#item'></div>

---

### Item select

The item select element is a quick and easy way to link your app data together, and bring in items from one app into another while you're working on a separate process. When you add an item select element you define which apps the user will select from. The participant then gets a drop-down list of all items they have permission to view within the reference app, and they can select individual items. Clicking on an item they've tagged will bring up the item details in a drawer, so they don't need to navigate away from what they're working on and can quickly reference details from the linked item.

![option item select](//images.ctfassets.net/6g4s9n00xmsl/6WcKZM24Gd5Ebas7OkPlB/e47af57dc2c5eb9806db4b668d75e9d8/option_item_select.png)

__Aligning OKRs to Company objectives__

Setting strategic OKRs requires individuals to contribute to the wider business framework. Aligning individual OKRs to [company objectives](https://www.peoplegoal.com/employee-performance-management/aligning-company-objectives) gives employees that framework and connects them to the organizational goals in a direct and meaningful way. Being able to view the full details of each objective when creating their OKRs also allows employees to see the Key Results and overall progress of the company goals, and get an idea of which targets need more support.

![option item select okrs](//images.ctfassets.net/6g4s9n00xmsl/fa5PTrk1d6iZxRsDD0P7F/b65402d90232260668c8d2b92e155a41/option_item_select_okrs.png)

__Referencing Reviews in a Development Plan__

[Development plans](https://www.peoplegoal.com/blog/development-plan) are very often set at the start of a new performance period, and taking into account comments made in any past performance reviews is helpful to start to frame your development goals. There's an added bonus with the flexibility of the item select element: managers can select their own performance review and their direct reports' reviews, to easily see the leadership areas they need to develop based on their employees' feedback.

![option item select devlelopment](//images.ctfassets.net/6g4s9n00xmsl/3yAJhpd0wP4x1n1iMYxwFc/7e3de2aefa017221df131bd192d60e00/option_item_select_devlelopment.png)

---

[Next, let's look at Numerical elements for capturing number inputs from your app participants.](https://www.peoplegoal.com/support/article/numerical-elements)

Option elements are used when you want participants to select their answers from a pre-built list - like performance ratings or multiple choice responses.

How to PeopleGoal option elements work?

Option Elements

# Install a Workspace

__Workspaces are the containers for all of your apps. Think of a workspace as a category within your account - like Performance Management, Onboarding and Talent Development. They make your [PeopleGoal](https://www.peoplegoal.com/product) account easy to navigate for users, and easy to manage for owners. Workspaces have their own permission settings which allows you to control who can see, create and edit all of the data contained in the workspace.__

When you're getting started it's easiest to install one of our workspace templates from the [App Store](https://www.peoplegoal.com/app-store). Once you get familiar with how it all works, you can head over to the [Become a Pro section](https://www.peoplegoal.com/support/category/become-a-pro) to create your own workspaces and edit the permissions.

Jump straight to:

- <a href='#install-a-workspace-template'>Install a Workspace Template</a>
- <a href='#navigate-the-workspace'>Navigate the Workspace</a>
- <a href='#manage-the-workspace-settings'>Manage the Workspace Settings</a>

<div id='install-a-workspace-template'></div>

---

## Install a Workspace Template

- Click on the __Workspaces__ icon in the navbar.
- Click __Create a new workspace__, then select __Store template__ to browse our available templates.
- You can use the filter to search for specific HR topics, or just browse all workspace templates. Click on a template to view the details and see which apps are contained within it.
- Click __Add this to your account__, then __Install template__ to confirm. We'll do the rest!

![peoplegoal install workspace](//images.ctfassets.net/6g4s9n00xmsl/45T7lSb0C7Sa6F951jg9NV/584494b8f442b722600afaa35f1dcb57/peoplegoal_install_workspace.gif)

<div id='navigate-the-workspace'></div>

---

## Navigate the Workspace

Your brand new workspace will now appear as an icon on the lefthand navbar. Click the icon to open the full workspace.

There are three main sections to a workspace - the __Apps__ it contains, the __Activity__ feed and the __Settings__.

![peoplegoal navigate workspace](//images.ctfassets.net/6g4s9n00xmsl/xzUW1CiGIWsg4h3zOJwzX/cd8bd5f504f4bf00635335f43795875d/peoplegoal_navigate_workspace.gif)

### 1. Apps

When you install a workspace template we'll automatically create the recommended apps, too. It's as easy as that! The __Apps__ tab will show you all of the apps contained within this workspace. You can learn how to manage those in the [Apps article](https://www.peoplegoal.com/support/article/apps).

![peoplegoal workspace apps](//images.ctfassets.net/6g4s9n00xmsl/5bGb95fOqYilQozpSykOCz/e8d5358ec9d6b786d2e0c28cb3ceaa6a/peoplegoal_workspace_apps.png)

### 2. Activity

The activity feed shows you a log of all changes and updates made to this workspace. This is useful when you have multiple workspace owners, so you can see who's making changes and when those took place.

![peoplegoal workspace activity](//images.ctfassets.net/6g4s9n00xmsl/6URxYNuNHhQ0IsDSijfQm3/da1f699281cfd5294009de61e0d392b7/peoplegoal_workspace_activity.png)

### 3. Settings

This is where you can change the name, description and look of the workspace, and set up your accesss permissions. We'll have all of this pre-built for you, but you can head over to Become a Pro to learn how to configure these yourself.

![peoplegoal workspace settings](//images.ctfassets.net/6g4s9n00xmsl/3xtfcz5WaWEhcfkRdf5oCD/9f4520785cb6a8d97ca84b3bcddbbba5/peoplegoal_workspace_settings.png)

<div id='manage-the-workspace-settings'></div>

---

## Manage the Workspace Settings

Workspace owners are the only ones who'll have access to the Settings tab. By default the person who installs the workspace is the owner, and you can give owner rights to other users later on.

- Click __Expand__ in the far right of each settings section to make your changes.
- Click __Save changes__ to lock in your updates, or __Cancel changes__ if you don't want to save any updates.

![peoplegoal manage workspace settings](//images.ctfassets.net/6g4s9n00xmsl/2ZceuUOnxzua5C0mpODzL4/f3f8c3f07bedae1b030437065690cdc0/peoplegoal_manage_workspace_settings.png)

### Details

Change the workspace name and description. Both of these are visible to all users who have permission to view this workspace.

### Image

This is the workspace cover image. Click the default image to update this.
- Select __Upload image__ to upload your own image file or click __Search for an image__ to browse the stock photography library.
- The workspace image is cropped 3:4 in the overall workspaces area, and circular cropped in the individual workspace view, so make sure to choose an image that works for both.

### Style

Select the workspace color and display icon. By default these will be the same for any new apps you create within the workspace.

### Status

There are two workspace statuses: __published__ and __draft__. When you install a workspace template it's already published, meaning it's visible to everyone and you can immediately start to use the apps within it.
- If you'd prefer to unpublish the workspace until you've made all the changes you want to, switch the "Published" toggle off.

### Permissions

Permissions control who can view and interact with your workspace. You should read our [Permissions article](https://www.peoplegoal.com/support/article/permissions) to understand this functionality fully. The [Become a Pro section](https://www.peoplegoal.com/support/category/become-a-pro) will show you how to change the permissions for your installed workspace template.

### Delete workspace

Proceed with caution here! Deleting your workspace will delete all of the apps within it, and any items created from those apps. __This cannot be undone__.

If you'd like to remove access to this workspace temporarily, then change the workspace status to draft instead.

---

Now that your workspace is set up and ready to go, it's time to [work with some apps](https://www.peoplegoal.com/support/article/install-an-app)!

Learn the basics of PeopleGoal workspaces and how to install a new workspace template.

Click on your Workspaces icon, then select "Create a new workspace". Click "Store template" to browse our Store and install one of our HR workspace templates.

How do I install a PeopleGoal workspace template?

Install a Workspace

Career development one-to-ones are a crucial part of employee development and growth. Luckily, they're easy to set up with PeopleGoal's app template.

How to create a Career Development One-to-One

How to create Career Development One-to-Ones

# Reports for Pros

PeopleGoal's reports builder lets you view every single data point in an app. This allows you to create custom reports and analyze the app data to draw the insights most needed for your business development.

Make sure you've read the Reports article in the Getting Started section to understand how the data view is structured, and how to create a report template. In this section we'll show you how to create charts from your data table and how to set up a regular recurring reports schedule.

To begin, open up an app and click on the __Data view__.

---

## Create Charts

Charts help to visualize the item data submitted by users in the app. You can build charts on top of the data table, and keep all of your raw data visible below.

You can create charts on the full data view, or on one of the report templates you've created.

To select a different report, click on the __Report name__ drop-down list and choose the report you want to work with. You can also choose to create a new report template here.

Click the __Chart__ button, then select the chart type you'd like to create.

The chart type you use will depend on the type of data you've recorded and how you want it to be displayed. When you're getting started try to create one of each chart type to get to know their features and which elements they work best with.

Once you've selected a chart type, a blank chart will appear. Click the __pencil icon__ in the far right to edit the data set(s).

### Reorder charts

You can create as many charts as you'd like within your report. They'll generate in a recommended display, but you can drag and drop your charts to other positions. You can also resize the vertical and horizontal borders to change the chart size.

Click __Save template__ to save your updates to this report.

### Understanding Charts

Now that you know how to create and reorder charts, let's get into further detail about using the various types of charts.

#### Line Chart

A Line Chart is great for tracking a variety of measures. Traditionally it is applied for monitoring change over time, for example the percentage completion of [team goals](https://www.peoplegoal.com/blog/how-to-set-clear-goals-for-your-team) over a quarter.

To set up a Line chart, click __Chart__ and then __New line chart__.

Then go to the top right of the box that appears and select the __pencil icon__. From this next screen, you can configure precisely what data you would like to interpret. Within these settings, you can alter the timeframe used in your chart, along with the various parameters involved.

To select the data you wish to be entered on the Line chart, scroll down and select __Add dataset__. In the new dataset box that appears select the data element you would like to learn more about. You can add multiple datasets to the same chart for a cross-analysis.

In our example, we have created a projection for the cumulative progression of SMART goals created in the [SMART Goals app](https://www.peoplegoal.com/app-store/template/smart-goals). Over the course of time, as more and more participants set their goals, the chart will develop.

![Line Chart](//images.ctfassets.net/6g4s9n00xmsl/2TtelAY4nReBS1NF2KUeyh/2e7cafbec41065def7ba119e4f67e342/Line_Chart.png)

#### Bar Chart

A Bar chart is one of the most traditional formats for presenting data. The simple structure can be easily interpretted by any individual, provided you have a clearly defined x and y-axis.

To set up a Bar chart, click __Chart__ and then __New bar chart__.

Then go to the top right of the box that appears and select the __pencil icon__. From this next screen, you can configure precisely what data you would like to determine. There are various options to alter how the bar charts will be displayed, you can edit based on your preferences.

To select the data you wish to be entered on the Bar chart, scroll down and select __Add dataset__. In the new dataset box that appears select the data element you would like to learn more about. You can add multiple datasets to the same chart.

If you would like to stack the charts on top of each other for a direct comparison, then be sure to toggle __Stacked__ to on when you add additional datasets.

This is what we have done in our example. We have created a Bar chart that presents each participants responses grouped together to better understand how each individual has responded to the form.

![Bar Chart](//images.ctfassets.net/6g4s9n00xmsl/TgYkuljEkHBg7oVHxdXzv/1b1ea6b823d5411457a574695aaad76c/Bar_Chart.png)

#### Pie Chart

The Pie chart is possibly one of the most recognizable formats for representing data. When using a pie chart, you are able to order all of your data points proportional to each other.

For example, you may want to establish how a team rated their overall performance in completing a project. This is what we have created in the image posted below.

To set up a Pie chart, select __Chart__ and __New pie chart__ to create the chart.

If you decide you would like to change the element that the Pie chart is presenting, then click on the __pencil icon__ in the top right of the box.

Here you can change the title of the chart, add annotations or change the element. Using the drop down box, for __Select element__, you are able to change the data that will be presented in the Pie chart. Simply select the relevant point or question of interest and click __Save changes__.

![Pie chart](//images.ctfassets.net/6g4s9n00xmsl/4wywErQ0PS7vt1Tsa9EaZp/e35accfde4dd2d84ef89ac51a63212c4/Pie_chart.png)

#### Polar Chart

Not to be confused with a Pie chart, the Polar chart provides an extra-dimension to the traditional Pie. Curated in a similar fashion, with proportional segments representing a specific data point, the Polar chart differs from the Pie chart due to the inflated nature of the segments.

A Polar chart will inflate each segment to a proportional size to demonstrate the population or responses of an element.

To set up a Polar chart, click __Chart__ and then __New polar chart__.

Then go to the top right of the box that appears and select the __pencil icon__. From this next screen, you can configure precisely what data you would like to determine.

Whatever data you would like to display on the Polar chart, go to __Select element__ and click on your desired element or question.

We've gone with the State element as our example. It presents a clear representation of how all participants are getting along with fulfilling their workflows and the colors can be altered to provide greater clarity on what each segment represents.

![Polar chart](//images.ctfassets.net/6g4s9n00xmsl/5gvEmbAT1xYSBvzxpsPBO1/18aff5cc76d80215b3a4f00f78a7364f/Polar_chart.png)

#### Radar Chart

A Radar chart, also known as a star chart, is a really helpful format for visualizing a comprehensive evaluation of your data. This vivid chart provides an intuitive description of data, whilst giving dynamic analysis.

To set up a Radar chart, click __Chart__ and then __New radar chart__.

Then go to the top right of the box that appears and select the __pencil icon__. From this next screen, you can configure precisely what data you would like to determine. Be sure to select how you would like to group data by the question/ focus for this chart.

To select the data you wish to be entered on the chart, scroll down and select __Add dataset__. In the new dataset box that appears select the data element you would like to learn more about. You can add multiple datasets if you would like to stack the charts on top of each other for a direct comparison.

As always once you're done configuring your chart, select __Save changes__ and enjoy your pretty chart.

The Radar chart is most effective when used to represent single select responses. This is what you can see in the example below for our analysis of [Company Culture Survey](https://www.peoplegoal.com/blog/top-10-company-culture-survey-questions) reponses.

![Radar chart](//images.ctfassets.net/6g4s9n00xmsl/49E0P93PRRq7itjcpH3MN/ced1ebd19c3bee340014ce4e405f3e29/Radar_chart.png)

#### Metric Chart

The Metric chart is a great tool to present any calculations or numerical data. With a Metric chart, you are able to apply functions to your data. For example, you are can present the average or sum of a particular response or completion slider.

To set up a Metric chart, click __Chart__ and then __New metric chart__.

Then go to the top right of the box that appears and select the __pencil icon__. From this next screen, you can configure precisely what data you would like to determine. Using the formula box, you can use the preset funcitons with your elements from the workflow to create any metrics.

In our example, we have created a formula to calculate the average goal progress for a specific team. Any users that look at the Data section will be able to see this projection, therefore indicating to them how well are performing in comparison to their peers.

![Metric Chart](//images.ctfassets.net/6g4s9n00xmsl/1pImAnD5Z3zeW7wGDvVGo9/7eb1d4ed7d6baff38cdae04458e1ebeb/Metric_Chart.png)

---

## Schedule Reports

Once you've saved a report template, you can schedule this report to run on a set schedule and notify selected recipients.

Open up the report template you want to schedule, then click __Schedule report__. This will pop open the Report Schedules view where you can see and edit existing report schedules.

### Create a new scheduled report

Click __Schedule new report__.

Select your report frequency (daily, weekly, monthly or yearly) and the send interval (every 1 month as an example).

Choose the start date and time on which your first report will be sent.

You can optionally choose an end date, too.

Enter your recipients' email addresses in a comma-separated list. Everyone on this list will receive the scheduled report at the times and frequency you've created above.

Enter an optional message to go along with your notification email and report attachment.

Click __Save report schedule__ to close.

### Edit a scheduled report

Open up your app's __Data__ tab, then click the __Schedule report__ button.

A list of all scheduled reports will appear here.

Click __Edit__ to change the report schedule details and add/remove report recipients.


Build custom reports on PeopleGoal using all of your item data to track the business analysis that's important to you.

PeopleGoal lets you build custom report templates using every data point in the account. Open an app and click on the Data view to create a report template.

How do PeopleGoal Reports work?

Reports

# Numerical Elements

__Numerical elements work with number values to capture numerical data and calculated outputs from your app participants. These can be applied to many different areas of your [HR workflow](https://www.peoplegoal.com/blog/workflow-examples) like salary data, compensation calculations, progress sliders and more.__

There are six numerical elements to work with:

- <a href='#number'>Number</a>
- <a href='#currency'>Currency</a>
- <a href='#percentage'>Percentage</a>
- <a href='#slider'>Slider</a>
- <a href='#range'>Range slider</a>
- <a href='#calculation'>Calculation</a>

<div id='#number'></div>

---

## Number

The Number element is a basic number input for participants to enter a value. These can be whole numbers or decimals, and you can set the minimum and maximum value in your Number element editor (leave these blank for no min/max). When providing their number response, users can type in a number or use the up/down arrows to increase/decrease their input.

![numerical number](//images.ctfassets.net/6g4s9n00xmsl/7jQUNbpHPQFT2MIzkLnGXC/3d9b3918c6dca0465003f8f90c4d3378/numerical_number.png)

<div id='#currency'></div>

---

## Currency

The Currency element works the same as the Number element, with the currency indicator automatically added to the numerical value. Click the __Select currency__ field in your element editor to choose your local currency.

![numerical currency](//images.ctfassets.net/6g4s9n00xmsl/1C5ImwyZ3LdrFkOWRt5MjN/781410b568cbca215b5938118a2ecdd7/numerical_currency.png)

__Training Course Costs__

When applying for external training courses under a department's budget, employees can use our [Training Approval app](https://www.peoplegoal.com/app-store/template/training-approval) to request approval for course registration. In the Training Course details, a currency element is included so that the Approver can assess whether the course is within the budget and appropriate for this course type.

![numerical training cost](//images.ctfassets.net/6g4s9n00xmsl/5VNpbx3MncOBjo42jAXrbB/4292dacd6a335afd7cc172166c7787e5/numerical_training_cost.png)

__Salary Input__

In a new hire application form or a compensation benchmarking process, include a currency field for the employee's expected salary. You can then report on the range of salaries added by applicants, use these for benchmarking in your compensation workflow, or compare expected salaries to the departmental budget.

![numerical expected salary](//images.ctfassets.net/6g4s9n00xmsl/6si6YLnAtIVMSsOyYkqXsT/95e551587b043e05900ee3ba9ae68697/numerical_expected_salary.png)

<div id='#percentage'></div>

---

## Percentage

And, just like the Currency element, the Percentage element adds the __%__ indicator to the end of the input percentage. On all of the numerical fields you can enter a placeholder number to give the participant an idea of what they should be entering - particularly useful in the Salary increase recommendation example.

![numerical percentage](//images.ctfassets.net/6g4s9n00xmsl/kbfihbpkgyC7WentBFLWz/4985f8942653d0955f0d6748fd7478dd/numerical_percentage.png)

__Salary increase recommendation__

We've included an HR/Finance review in our Performance Reviews app. This app makes use of a few different element types! First we pull the employee's current salary using the Profile value element. Next we add our percentage element to ask the HR/Finance reviewer for their recommended percentage increase. This is a great example of using an anchor placeholder - we've set this at 5% as a benchmark. Once the participant puts in their recommended increase, a calculated element will show the final salary after the increasee is applied.

![numerical increase](//images.ctfassets.net/6g4s9n00xmsl/2MCEZtUExRjP85sqM8mKaU/2295b3a2685f349b5ec53a98bd0aecbe/numerical_increase.png)

__Weighted OKR contribution__

If you want to get really technical with your Key Results progress, you can add a percentage weighting to each key result. You can then apply the weighted percentages to your progress calculation, making sure that some key results count more than others.

![numerical okrs weighting](//images.ctfassets.net/6g4s9n00xmsl/2qcHkiM4UOm7b7MBnSYXbY/030a6222c15a42b6cb71e50ebf1bc2b7/numerical_okrs_weighting.png)

<div id='#slider'></div>

---

## Slider

The Slider element lets users click and drag the slider along a pre-defined scale. This can be anything you like - we default to a 0 - 10 scale, but you can set your minimum and maximum values in the elemnet editor. Some people prefer to use the slider for performance ratings over the drop-down select.

In the __Select label type__ field you can choose a percentage or currency label. When you're assessing progress the slider is a more intuitive element to use than the percentage input.

You can also choose to display your slider horizontally or vertically. A vertical slider works best when it's a smaller scale (0 - 5); and for anything larger we'd recommend using the horizontal display.

![numerical slider element](//images.ctfassets.net/6g4s9n00xmsl/4r8yeFfQj2e8s5kiTgyIKz/47c2f678f2cdb1b2a8d7cae524223ece/numerical_slider_element.png)

__Goal progress__

The most common use case for a slider is to indicate the overall progress of your goals and objectives. Set the slider to a 0 - 100 scale (or 120 if you want to capture how far people exceed their targets!) and employees will click and drag to indicate how far along they are in achieving their targets.

![numerical okrs progress](//images.ctfassets.net/6g4s9n00xmsl/3SWaOAzfaLgQByQQELXc6i/ac179fbccc8c37f44e0e9ab9c15fa4d3/numerical_okrs_progress.png)

__eNPS__

eNPS stands for [Employee Net Promoter Score](https://www.peoplegoal.com/blog/employee-net-promoter-score), and is taken from the NPS - a score typically used to assess how likely someone is to recommend your business or product to others. In the context of employee engagement this is a really easy to measure metric that asks employees on a scale of 0 - 10, how likely are they to recommend your company as a great place to work. You can use this score to benchmark your overall company satisfaction in your first engagement survey, and then track your progress as you run more surveys.

![numerical enps](//images.ctfassets.net/6g4s9n00xmsl/n2cul3RGUyYYpHrDzApS5/b9dcc04e8e2c89b6aa0c455901292625/numerical_enps.png)

<div id='#range'></div>

---

## Range Slider

The Range Slider has all the same options as the Slider element, but gives you two indicator points along the slider bar.

![numerical range slider element](//images.ctfassets.net/6g4s9n00xmsl/4R0xdp2EOUNs8CoSz6QyJ0/128de4a750d1c4fb74bf1a2904e2b044/numerical_range_slider_element.png)

Users will input both a minumum and maximum value (instead of a single-point value in the slider element) to show a range in their response. Some areas where this is used include:

__Baseline vs. Target indicator__

When setting up quantitative targets it's really useful to track your baseline (your starting point) vs. your target value. Using a range slider lets you easily visualize your current progress vs. the baseline, and how far you are from achieving your target.

![numerical targets slider](//images.ctfassets.net/6g4s9n00xmsl/5EwCS5X7CpvEQlqrak0utk/735c9928adf0bb60f71d1e9884d56b33/numerical_targets_slider.png)

__Salary range__

In a new applicant tracker or a compensation assessment, use thee range slider to ask what salary range this particular role falls under. This data can then be used in your reporting, or simply to assess whether the applicant's expected salary is within the range for this department's budget.

![numerical salary range](//images.ctfassets.net/6g4s9n00xmsl/3oeiKIfMOKBUKVjUqY7PA4/09ecefdee7cd816e57573b8301dc890a/numerical_salary_range.png)

<div id='#calculation'></div>

---

## Calculation

The Calculation element has a huge range of applications - from showing average [performance review](https://www.peoplegoal.com/blog/performance-review-ratings-are-they-necessary) ratings to calculating what a final salary would be after an increase is applied, or tallying up how many responses have been given within a survey. The Calculator element can be used on any form element where a numerical value applies; so every element in the Numerical group as well as Selects and Grids.

To start building your calculation:

- Name your element (e.g. Total pay packet after bonus)
- Select how many decimal places to display in the calculation
- Add an optional prefix or suffix (e.g. a currency placeholder for $ values)
- In the formula bar, select from the Functions (sum; average; count) and Operators (add; subtract; multiply; divide) and then scroll down to select which Elements to calculate.
- In the Formula bar your element IDs will display, with a preview in the field below. Remember to encase all elements in brackets.
- Underneath the Formula area, your output Result will display in grey, or you'll see red error indicators to update your formula until it's correct.

![numerical calculation element](//images.ctfassets.net/6g4s9n00xmsl/1bfiAqX3ukhFUwyYi8TlHW/da67fc96216a63834637641bba3554e8/numerical_calculation_element.png)

__Compensation and bonus calculation__

Going back to our Percentage example, the calculated element is used to show what the employee's next salary will be after their increase. The structure of the calculation is simple and uses just the two elements above. You can see your output below the Formula field to check if the formula structure is correct.

![numerical salary calculation](//images.ctfassets.net/6g4s9n00xmsl/72IivE8sho3g4TKbHCaJdh/e27fd54aa6dde843ccd56a55f183e19d/numerical_salary_calculation.png)

__Average performance review ratings__

As an overall indication of a review score, we've taken an average of the employee, their line manager and their senior manager's review scores. You can also calculate an average of responses to individual review questions to show an overall average, and then create an additional option > select element for the reviewer to select a final score in line with your review ratings.

![numerical calculation review rating](//images.ctfassets.net/6g4s9n00xmsl/17TK4iWh3dOqdFKhPmGJg7/27943a9f8255a56d59a55e48b1bc1163/numerical_calculation_review_rating.png)

*Note that when users start filling out their items, they will need to save their changes for an initial calculation to display, and save again to update the calculation after any additional changes to their responses.*

---

[Next, let's look at Calendar elements for setting dates and times in your app templates.](https://www.peoplegoal.com/support/article/calendar-elements)

Numerical elements work with number values to capture numerical data and calculated outputs.

What do PeopleGoal numerical elements do?

Numerical Elements

# How to Install Dummy Data

Whether you're experimenting with creating a new review or you're learning how to use the Data charts, the Dummy Data feature can be extremely helpful when first getting to know PeopleGoal. The purpose of Dummy Data is to allow you to run test reports and apps to get a better understanding of how the whole process works.

### What is Dummy Data?

Dummy Data is exactly what it says on the label. It is an artificial database of fake employees that can be used to replicate the behavior patterns of real users.

In order to get started with using the Dummy Data, there are a couple of steps you need to take in order to get the fake accounts up and running.

- Authorize Dummy Data for your [PeopleGoal](https://www.peoplegoal.com/product) Account
- Enable Dummy Data in an App
- Get to know PeopleGoal through our Dummy Data

---

## Authorize Dummy Data for your PeopleGoal Account

The first step in using Dummy Data is to get the data enabled. Until you enable Dummy Data, you will not be able to use it in any of your apps.

- To do this, click on your __Account__ menu in the lefthand navbar, and go to __Settings__.
- From the Settings menu, you'll be able to see *Dummy Data* as one of the options. Select this and toggle on the Dummy Data before clicking __Save changes__.

![switch on dummy data](//images.ctfassets.net/6g4s9n00xmsl/5sjRwScHKaWgWRB1SMVrgh/bc23d47ae6165e89c5db681b2597ccea/switch_on_dummy_data.gif)

Dummy Data is now activated and available to use on your account. You'll now have dummy Teams and Relationships created too.

---

## Enable Dummy Data in an App

With your Dummy Data enabled, you can now go ahead and start enabling it for whichever apps you intend to use.

You can't enable Dummy Data from the Workspace settings; you will need to go into an app itself and from here go to the app Settings.

- The __Settings__ tab for each app can be found above the active items - it's the last one along from the Template menu option.
- Just as you did with the main Settings menu - scroll down to *Dummy Data* and click on __Expand__.
- Then all you have to do is toggle the switch on and select __Save changes__.

![dummy data app](//images.ctfassets.net/6g4s9n00xmsl/2QagfSFgeWmd2BkWHjUN7B/30451b76af992645923ac5e5a1b53687/dummy_data_app.png)

Whichever apps you have now enabled Dummy Data for will start producing artificial items and responses. Although, don't expect anything insightful from them, as all of our dummy users only speak Latin.

![dummy data app view](//images.ctfassets.net/6g4s9n00xmsl/7En69GFc01piTunuXo6WOt/78afedd9e083dd89644b28695a64c9c6/dummy_data_app_view.png)

---

## Get to know PeopleGoal through the Dummy Data

Your account is now set up with Dummy Data enabled on whichever apps you have chosen to activate.

Have a play around with some of the charts in the Data tab to learn more about how you can visualize quantitative data. Equally, check out how the workflows will look once users fill in their information.

The purpose of Dummy Data is to help you develop a greater understanding of the capabilities and power of PeopleGoal.

Of course, this is only a taster of how your own company would be using the software, and you should always aim to test your processes with your own pilot team. Nevertheless, it is a useful tool to shine greater clarity as you are first getting to know the ins and outs of running performance reviews or creating company-wide OKRs.

Switch on Dummy Data to test processes in your PeopleGoal account

How to switch on Dummy Data to test processes in your PeopleGoal account.

Install Dummy Data on PeopleGoal

Switch on Dummy Data to test processes and reports in your PeopleGoal account.

Install Dummy Data

# Install an App

__Now for the fun part - working with apps! Apps are the actual HR workflows that users will interact with. Performance Reviews would be an example of an app within the Performance Management workspace.__

When you install a workspace template you'll automatically install all of the apps it contains, so you can get up and running straight away. You can of course edit these apps to suit your own company details. Once you get familiar with how it all works, you can head over to the [Become a Pro section](https://www.peoplegoal.com/support/category/become-a-pro) to create your own apps, set up states and conditions, and configure the app permissions. You can also check out our [How-To articles](https://www.peoplegoal.com/support/category/how-tos) with step by step instructions for installing, configuring and launching all of our pre-built apps.

Jump straight to:

- <a href='#how-do-apps-work'>How Do Apps Work?</a>
- <a href='#find-your-apps'>Find Your Apps</a>
- <a href='#install-an-app-template'>Install an App Template</a>
- <a href='#navigate-the-app'>Navigate the App</a>

<div id='how-do-apps-work'></div>

---

## How Do Apps Work?

Apps are the workflows that define your HR processes. Each app is __template__ for the workflow you want to execute, and users will create __items__ defined by the app template.

App templates are constructed of __Sections__ and __Elements__. Every single element is fully customizable by the app owner but don't worry about that for now - the app templates you install from our Store come fully set up and ready to go.

Apps move through multiple __States__. This allows many people to contribute to the HR process and apps can have as many states as you need. As an example, a simple [Performance Review](https://www.peoplegoal.com/product/performance-reviews-software) app would include these states:

- *1. Employee self assessment* (employee completes their section)
- *2. Manager assessment* (manager views the employee responses and completes their section)
- *3. HR confirmation* (HR views the employee and manager submissions, and adds private HR comments for employee records)
- *4. Manager confirmation* (manager receives the confirmed review back and adds final comments)
- *5. Employee confirmation* (employee receives the final review form back)

Each state has one __participant__. In our example above, the participants are employee, manager and HR. Because there's no limit to the number of states you can create for an app, you can have any number of particpants weighing in on complex processes - each with their own visibility and access permissions when the app comes round to them.

You can automate the app workflow further by defining state participants according to pre-set relationships within your account. If you predefine the manager relationship then any time an employee starts a new review the "manager" participant will be automatically assigned.

Ready to start working with apps? Let's go!

<div id='find-your-apps'></div>

---

## Find Your Apps

__Apps need to belong to a workspace__.

If you've installed a workspace template, the apps will come pre-installed along with it. 

- To find these, hover over your workspace icons in the navbar and a list of all the apps within this workspace will appear.
- Click on an app name to open it up.
- Or click on the workspace icon and you'll be taken to the full table view. If you've already got apps installed they'll appear here, or you'll see a blank workspace and you can start to install app templates from here.

![peoplegoal open app](//images.ctfassets.net/6g4s9n00xmsl/6Coibal0lJFJm7Lcg7IkqJ/107549eaf42cf87774084b33a3011a03/peoplegoal_open_app.png)

<div id='install-an-app-template'></div>

---

## Install an App Template

If you're not seeing an app you want to include in your workspace by default, you can add as many additional apps to a workspace as you need!

- Make sure you're on the __Apps__ tab of your workspace.
- Click __Create a new app__, then select __Store template__ to browse our available templates.
- You can use the filter to search for specific HR topics, or just browse all app templates. Click on a template to view the details and see if it's right for you.
- Click __Add this to your account__, then __Select workspace__. Choose the workspace you want this app to belong to (it doesn't have to be the workspace you're currently on).
- Click __Install template__ to confirm and we'll do the rest.

![new joiner survey install app](//images.ctfassets.net/6g4s9n00xmsl/5pg3I9TemAYY2FBHrz2MOg/2be007a3d86b638ebc33afa483edcccb/new_joiner_survey_install_app.gif)

<div id='navigate-the-app'></div>

---

## Navigate the App

There are five main sections to an app, which you can switch through in the horizontal tab ribbon.

### 1. Items (app name)

Items are an instance of an app. So when someone creates a new performance review, that's an __item__ using the Reviews __app__ template.

Item views are grouped in folders running down the left of the app. These folders are:

- __You__: your own items, e.g. personal OKRs you've created for yourself
- __Your Colleagues__: any items you're participating in, e.g. if you're providing a manager's assessment for a direct report's review. Colleagues are groupd by relationship types.
- __Your Teams__: items grouped by the teams in which you're a member. Note that even though you can see all teammates' names in this view, if you don't have specific permission to view their items then nothing will display under their name.
- __All Items__: app owner view of all items in this app.

![peoplegoal app views](//images.ctfassets.net/6g4s9n00xmsl/76pRp4Vam2kJxTPvXHrpev/6b1ad52c27a7a121f31e8f665f3c782b/peoplegoal_app_views.png)

### 2. Template

The real power of your workflow lies here! The app template is where you build your process form - including all elements to be completed, as well as the custom states and rules. Because you've installed a pre-built template this is all set up and ready to go. Head over to the [Become a Pro section](https://www.peoplegoal.com/support/article/apps) if you want to learn how to configure the template and set up states, rules and conditions, or go to our [How-To articles](https://www.peoplegoal.com/support/category/how-tos) to get a step by step guide for every app.

![peoplegoal app template](//images.ctfassets.net/6g4s9n00xmsl/16SbqjzFNRbg2Rm7W5Jd8H/1bd29dfb2b014ffdcb91dcf4bb7dc7a2/peoplegoal_app_template.png)

### 3. Data

Every single element on [PeopleGoal](https://www.peoplegoal.com/product) has a unique ID, which allows app owners to generate a full report of every single data point in this Data view tab. We'll show you how to build your own custom reports in the [Reports article](https://www.peoplegoal.com/support/article/reports).

![peoplegoal app data](//images.ctfassets.net/6g4s9n00xmsl/4ysxZ10XdsnkpagHpnGcqv/391fd1d2ee7545f9f6305f1e0430c655/peoplegoal_app_data.png)

### 4. Activity

The activity feed shows you a log of all changes and updates made to this app. This is useful when you have multiple workspace owners, so you can see who's making changes and when those took place.

![peoplegoal app activity](//images.ctfassets.net/6g4s9n00xmsl/22fN0X5QCpEkd3v3bz30j3/52bdaa15ed4d2b7fc151ccf77dd5d825/peoplegoal_app_activity.png)

### 5. Usage

This tab will show you a report showing the count of items created, updated and deleted within your app. This is useful for monitoring just how often users interact with the apps you've created, and validating if that is in line with your performance cycle.

![peoplegoal app usage](//images.ctfassets.net/6g4s9n00xmsl/1PQuXg1KKjGo5cyRZx2Ehf/a6ccb7e0284d97af29752bb5c30879ca/peoplegoal_app_usage.png)

### 6. Settings

This is where you can change the name, description and look of the workspace, and set up your accesss permissions. We'll have all of this pre-built for you, but you can head over to [Become a Pro](https://www.peoplegoal.com/support/article/apps) to learn how to configure these yourself.

![peoplegoal app settings](//images.ctfassets.net/6g4s9n00xmsl/6mEwSKSMg03wqdFEsXA8HU/566101ed278141ca0f1e85488ad26cd0/peoplegoal_app_settings.png)

---

... Getting there! You've got the majority of your account sorted now, and you can start to test PeopleGoal's features by [creating items](https://www.peoplegoal.com/support/article/create-an-item).


Learn the basics of how apps work and how to install an app template from the Store.

Open up the workspace you want the app to belong to, then click "Create a new app". Select "Store template" and browse from hundreds of HR process templates.

How do I install a PeopleGoal app?

Install an App

# How to set up a Company Culture survey

__Running a regular company culture survey will establish a strong and positive organizational culture. By creating a survey that is easy to follow with automatically scheduled reminders, you will achieve higher response rates and a more cohesive company culture.__

Creating Company Culture Surveys with PeopleGoal couldn't be easier. This 'How-to' article will take you through the neccessary steps to get your Culture Survey up and running in a matter of minutes. The app template has been created for you and is ready to use straight away, or you can customize the question set further to align with your own company values and ways of working. This survey can also be sent anonymously by using the webform function in the app settings.

Follow these steps to install and launch your Company Culture Survey within minutes: 

<a href="#install-culture-survey-app">1. Install the Company Culture Survey app template</a>

<a href="#customize-culture-survey-app">2. Customize the Company Culture Survey app template</a>

<a href="#set-anonymous-culture-survey-responses">3. Set anonymous company culture survey responses</a>

<a href="#set-permissions">4. Set the Company Culture Survey Permissions</a>

<a href="#launch-survey">5. Launch your Company Culture Survey!</a>

<div id="install-culture-survey-app"></div>

---

## 1. Install the Company Culture Survey App Template

- Open any workspace, then click __Create a new app__ and select __Store template__.
- Select the __Company Culture Survey__ and click __Add to your account__.
- Select the workspace you want this app to belong to, then __Install template__.

![company culture survey install app](//images.ctfassets.net/6g4s9n00xmsl/3PQ121NhwQjcx49lKIK5uJ/39427b71758c9383ca2f551b0eff106c/company_culture_survey_install_app.gif)

We've already built a list of questions and answer sections ready for you to get started with the survey right away. If you're running a culture survey for the first time, this is a best-in-class set of questions so you can start using the app immediately. Jump to <a href="set-anonymous-culture-survey-responses">step 3</a> to learn how to set up participants and permissions for your surveys, or continue on below to customize the survey questions.

<div id="customize-culture-survey-app"></div>

---

## 2. Customize the Company Culture Survey App Template

To customize the questions in your survey, click the __Template__ menu, then __Edit template__. 

Using the easy template editor you can insert elements for different styles of questions - select boxes, written responses, sliding scales and more. 

![company culture survey edit template](//images.ctfassets.net/6g4s9n00xmsl/6UNOWMcQyMeV4sG2feosYj/c9f30ce72718336b2a61c82837b950b2/company_culture_survey_edit_template.png)

### i. Edit existing elements

Elements are your individual form fields that make up your survey. These can be anything from text questions to rating selects, display-only fields or numerical calculations, and every element can be changed to suit your custom process and company culture.

- To change a field, hover over the right-hand side of the element and click on the three dots that appear.
- Select __Edit element__ (your element will have a name such as "Select", "Description", "Rich-text area" etc). This will open up the element editor.
- Make any changes to the fields where you need and click __Save change__ to update.

In this example, we will change the "Our company culture focuses on integrity, teamwork and co-operation" field to have a different question title and display text to better suit your company language. Additionally, we can alter the field to make the response optional by marking it "not required".

![company culture survey edit element](//images.ctfassets.net/6g4s9n00xmsl/2bV22hOfTsW6seaCzIO0wA/a65f2a495f567e22bcd122e75ca59eab/company_culture_survey_edit_element.gif)

You should note that these changes only apply to that specific element. This means that if you were to change the rating set on one element you will need to change any other questions to match this. But don't worry, to prevent you from trawling through every individual element you have an option to duplicate an element once you've got it set up to your liking.

### ii. Duplicate elements

- Hover over the right-hand side of the element and click on the three dots that appear.
- Select __Duplicate element__ and an exact copy will be created below.
- Edit the duplicated element to change your question text, and click __Save changes__ to update.

![company culture survey duplicate element](//images.ctfassets.net/6g4s9n00xmsl/2nRJYdfUzaYUNBE2Cx4dRO/d81d54d4443180a0a7bfe30a32df0c9a/company_culture_survey_duplicate_element.png)

### iii. Reorder elements and sections

Reordering is very straightforward - simply click and drag to change the element or section order.

- Hover over the left-hand side of the element (or section title) to click and drag your element or section to its new location.
- To move an element to a different section, hover over the right-hand side and click the three dots that appear.
- Select __Change section__ and choose the new section you want the element to belong to.

![company culture survey change section](//images.ctfassets.net/6g4s9n00xmsl/80q3ej5yFl4oVX62tOYHZ/4345cc1ddd0d5375849850afb2982f13/company_culture_survey_change_section.png)

### iv. Create new elements and sections

At the bottom of each section, click __Add element__ and select the element type you want to insert.

A new element that's useful to add to your first section is a display-only Description or Rich-text area. You can use this to remind employees and managers of the purpose of taking a company culture survey, or give instructions on how to complete the survey.

To add a new section, scroll to the very bottom of your template form and click __Add section__. Then click and drag your new section to where you want it to sit in the survey flow.

![company culture survey add section](//images.ctfassets.net/6g4s9n00xmsl/7ye4FA0yd3UpgsY3Ujhy4s/6a01a11ddf568b1e0aa229cde4879c54/company_culture_survey_add_section.png)

<div id="set-anonymous-culture-survey-responses"></div>

---

## 3. Set Anonymous Company Culture Survey Responses

Now that you've got all of your questions in order, you're almost ready to launch! There's just a couple of permissions that you'll need to set first.

The strength of company culture surveys is the value of the anonymity they offer. Giving employees the opportunity to provide honest responses, without concern for the repercussions, enables teams to build on truthful and therefore valuable feedback.

### i. Set anonymous responses only

For the protection of the employee's identity, use the webforms functionality to allow users to fill in surveys without any connection to their [PeopleGoal](https://www.peoplegoal.com/product) account.

- Click on the __Settings__ menu, then expand the __Webforms__ section.
- Ensure that the toggle for __Webform enabled__ is on (it will be colored blue).
- Check that __Anonymous responses only__ is also on/blue.

You can then copy and share the link that appears above the toggles to invite employees to conduct the surveys anonymously.

![company culture survey webform](//images.ctfassets.net/6g4s9n00xmsl/5pfO7BZdEPkUOzQqJVvqzC/ff7fbcebb77cf869564363bbf14cb578/company_culture_survey_webform.png)

<div id="set-permissions"></div>

---

## 4. Set the Company Culture Survey Permissions

Permissions control the access to your app within your PeopleGoal account. Different levels of access will determine to what extent users can create/edit surveys.

- Set permissions by clicking on the __Settings__ menu, then expanding the __Permissions__ section.
- Click on *Explain permission types* to understand the access that each permission gives your account users.

![company culture survey permissions](//images.ctfassets.net/6g4s9n00xmsl/50i8liy8Ubb73Uv9FrOzF1/27efc0a9cb40a10e88b489a5640fd5bc/company_culture_survey_permissions.png)

### i. App-wide permissions

For Company Culture Surveys, we'd recommend you set the permission to __Create only__. This will allow employees to create surveys for themselves, but without being able to see any colleague's survey responses.

### ii. Specific user permissions

The user who installed the Company Culture Survey app template has __Owner__ permission by default. Any specific team and user permissions supercede the default permission type.

- Assign a specific permission by selecting __Configure specific permissions__.
- Under "User permissions" click __Add user__.
- Type your colleague's name to add them to the permission list. In the "Permission type" column, select which permission level to give them.

It's a good idea to give "Create and view" access to your C-Suite, so that they can see all survey responses without needing access to the app settings or template.

![company culture survey specific permissions](//images.ctfassets.net/6g4s9n00xmsl/38C96utpBKmVHj94Q2RBeX/3d34da8be6d6b434f0fb6648ba720ab0/company_culture_survey_specific_permissions.png)

### iii. Specific team permissions

If, for example, you have a specific team that you intend to grant permissions, then under "Team permissions" click __Add team__.

Just as with "User permissions", type the team's name to add them to the permission list. In the "Permissions type" column, select which level to give them.

<div id="launch-survey"></div>

---

## 5. Launch your Company Culture Survey!

You're now all set to go! With all of your questions prepared and anonymity confirmed, start sending out your survey webform links.

You can also run the survey in-app, if you would prefer to attach employee names to surveys. 

### i. Start a new Company Culture Survey

- Click on the Culture Surveys homepage.
- To start a survey for yourself, select your own name.
- To start a survey for an individual, click __Select user(s)__ and search for individual employee names.
- Or, click __Select team(s) of users__ to kick off surveys for entire user groups. You can select your Company team here to start a survey for everyone in the account.

![company culture survey launch](//images.ctfassets.net/6g4s9n00xmsl/6leIgjVEY2zR0464P7zClN/368bc185a4e461420f535246212145e0/company_culture_survey_launch.png)

### ii. Schedule Company Culture Surveys

You may want to schedule a survey for a future date, or set up a recurring survey.

- On the App homepage, select __Add ...__, then click __Schedule...__. This will create a content box above the __New Company Culture Survey__ button.
- Hover over the right side of the box and click on the pencil icon.
- Here you can enter information for the schedule description that can be displayed on the dashboard. Select the "Show on dashboard" toggle to enable this.
- Then click on __Add event__ and write in the relevant information. Here you can set the date for the survey, a reminder notification, toggle if the survey is recurring and how frequently they will be set.
- You can schedule surveys based on a fixed date or an employee profile date (like their start date).
- You may also want to select the toggle for "Automatically create new Company Culture Survey" to automate the process. Then click __Select participant__ to set the respondent to the Employee participant.
- Be sure to select __Save changes__ before leaving each page.

![company culture survey schedule](//images.ctfassets.net/6g4s9n00xmsl/1RSEPBXzvqUCG0aF7F6tEm/a095bfbf235cf2cb85c71f25ba9b00f9/company_culture_survey_schedule.gif)

---

### Next steps: set up your custom company culture survey analytics and reports

We are aware that [every organization](https://www.peoplegoal.com/blog/top-10-company-culture-survey-questions) has its unique ways of working, and the metrics you analyze in [culture surveys](https://www.peoplegoal.com/blog/company-culture-survey) are different to any other company. This is why in the Data table, we record every single data point from your surveys app, so that you can build custom reports and automated charts. [Take a look at our Reports building article](https://www.peoplegoal.com/support/article/reports) to learn how to create custom reports and analytics tracking.

---

Since you should now have your [company culture surveys](https://www.peoplegoal.com/blog/top-10-company-culture-survey-questions) up and running, take a look at the other apps you can install within your Culture workspace. We recommend implementing a [Diversity and Inclusion survey](https://www.peoplegoal.com/app-store/template/diversity-and-inclusion-survey-detailed) which will allow you to initiate a continuous process for measuring diversity and inclusion in your organization. Additionally, [Employee Experience Surveys](https://www.peoplegoal.com/app-store/template/employee-experience-survey) are important as they will help you better understand employee experience at your company. You can find all of these and more in our [App Store](https://www.peoplegoal.com/app-store).

Don't have a PeopleGoal account yet? [Book a demo](https://www.peoplegoal.com/book-a-demo) to see our no-code [HR workflow](https://www.peoplegoal.com/blog/workflow-examples) builder in action!

Measuring how employees see your company culture is easy to set up with PeopleGoal's one-click survey installation.

Measuring how employees see your company culture is easy to do with PeopleGoal's quick survey.

How to Measure Company Culture with a Survey

How to set up a Company Culture survey

# Calendar Elements

__The calendar elements allow the user to input a specific date, date range, date time or just a time. These are particularly useful when scheduling one-on-one meetings or [check-ins](https://www.peoplegoal.com/blog/check-ins) with your manager, and for specifying by which date you aim to achieve a certain task or objective. Having a date/time picker, as opposed to inputing the information numerically, is more user-friendly, and a great way to visualize the information.__

What's more, you can set rules within [PeopleGoal](https://www.peoplegoal.com/product) that trigger calendar invitations via email to users based on the date/time inputted into the form. This really useful feature will align user's calendars with the PeopleGoal apps. This is covered at the end of this section.

![calendar elements](//images.ctfassets.net/6g4s9n00xmsl/TlIflMs3gnEZysxx7khFR/f4c268f0b58bc84d354ce3605ac39a60/calendar_elements.png)

The calendar elements available are:

- <a href='#date'>Date picker</a>
- <a href='#range'>Date range picker</a>
- <a href='#datetime'>Date time picker</a>
- <a href='#time'>Time picker</a>

<div id='#date'></div>

---

## Date picker

The date picker element allows the user to input a date into the form. There are two ways this can be displayed, either as an *Input* which will look like a typical response field but will expand to a calendar when you click it, or as a *Calendar* which will take the appearance of a calendar from the outset. Both function in exactly the same way - it just depends on how you want to form to look.

You must also set a minimum and maximum date that the form covers. It is advisable to set the date range for a long period of time, to avoid problems with users inputing data. However, you can adjust this according to your needs.

![calendar element date picker](//images.ctfassets.net/6g4s9n00xmsl/5mnKPcWXICIcPgDYN6VsFD/e310cfeb23858850bc9b3608f3685071/calendar_element_date_picker.png)

__Goal setting__

Date pickers are really useful when setting objectives or goals as they allow users to set a date by which the aim to achieve the objective. They can then measure their progress towards their objective based on how long they have left to complete it. They can be used during goal-setting, development plans or even performance reviews - depending on how you run your process.

__Check-ins__

Another great way to use the date picker is when setting up one-to-one meetings or check-ins. Use the calendar option to allow users to select a date they want to meet with their employee or manager. We can then set up a state rule which will send a custom email to participants and add the event to their calendar. How to do this is covered further on in this article.

<div id='#range'></div>

---

## Date range picker

The date range picker is similar to the date picker, the difference being is that the user selects a time period rather than a specific date. This is particularly useful when assessment performance over a period of time, for example in a performance review. The functionality of the element is exactly the same as the date picker element. Name the element, select the input type (*Input* or *Calendar*), set a minimum and maximum date.

__Performance Reviews__

The date rage picker element is particularly useful when setting up a performance review or appraisal form. The user is able to select the period of time that the performance review covers. You can give some guidelines using *display only* elements to instruct the user on the performance review cycle dates.

<div id='#datetime'></div>

---

## Date time picker

The date time picker functions in a very similar way to the date picker, with an additional option to choose a time. This will allow users to request a fixed meeting with the direct report or supervisor. This is a great way to make sure face-to-face conversations are happening alongside your online processes.

__Check-ins__

A great way to use the date picker is when setting up one-to-one meetings or check-ins. Use the calendar option to allow users to select a date and time they want to meet with their employee or manager. We can then set up a state rule which will send a custom email to participants and add the event to their calendar. How to do this is covered further on in this article.

<div id='#timee'></div>

---

## Time picker

The time picker is an element that allows the user to input a specific time. This could be useful if they want to request a meeting with a direct report or supervisor on a predefined day. For example, if all monthly or bi-annual check-ins are on a fixed day, the user will only have to request a time slot. 

__One on ones__

Use the time picker to request a specific time for a one-on-one meeting with your direct report or supervisor. We can then set up a state rule which will send a custom email to participants and add the event to their calendar. How to do this is covered further on in this article.

---

## Trigger a calendar invitation from a calendar element

You can send out a calendar attachment with your notification by creating a new state rule. To do this:

- Click the __Templates__ tab of your app, then select __Set rules__.
- Click the state icon in the workflow visual to set it as the active state.
- Then click __Create a new state rule__.
- Click the title (defaults to "Submission rule in state") to change the name of your rule. This helps you to identify what the rule is doing and to put it in the correct order if you're using multiple rules.

Now you're going to set up your conditions and actions. Conditions are the parameters that need to be met to trigger the action. For calendar invitations you don't need to set any conditions, as these will be triggered simply by moving the form into the next state.

Next you'll create an action to trigger a custom email to be sent, along with a calendar attachment.

- Click __Add an action__ to get started.
- Click __Send email__, select which app participants should receive the email, and enter your subject line and content.
- Click __Show additional email options__ to add recipients who are not participants, or who have an external email address.
- Toggle on "Include calendar invitation", which will automatically send a calendar invitation to the participants that you have selected or manually inputted.
- Click __Save changes__.

![calendar invitation actions](//images.ctfassets.net/6g4s9n00xmsl/63f9UolRbxpvqWFVwLSbLf/d1eccdefc1fa4b497bf28f19afdc96a6/calendar_invitation_actions.png)

You are not limited to just one action - you can add as many actions as you like to each rule. We also recommend setting a rule that will show the date on the timeline on the dashboard. 

- Click __Add an action__ and then __Create a timeline event__.
- Select which participant should have the timeline event triggered, and add a timeline event description.
- Click __Save changes__.

---

[Finally, we'll take a look at Web elements for embedding links and downloads in your app templates.](https://www.peoplegoal.com/support/article/web-elements)

Calendar elements are particularly useful when scheduling one-on-one meetings or check-ins with your manager, and for specifying by which date you aim to achieve a certain task or objective.

Calendar elements allow you to set a date and time in your app workflow, and can generate a calendar invitation to all participants.

How do the PeopleGoal calendar elements work?

Calendar Elements

# Account settings

__Account owners will set up a few account details when they create their [PeopleGoal](https://www.peoplegoal.com/product) account, and owners can edit these in the Account settings menu.__

Click on the __Account__ icon in your navbar, then select __Settings__.

---

## Change Details

- Click __Expand__ to open the settings options.
- Click __Save changes__ to save your updates or __Cancel changes__ to leave without saving.

### Name

Update your company name.

### Subdomain

Every account has a unique subdomain on PeopleGoal. This helps to scope off your account to your users, and lets employees search for your company account to request to join.

Your subdomain needs to be unique (not owned by any other account) and you should try get it to match your organization name exactly, to make account search easy for [new joiners](https://www.peoplegoal.com/app-store/template/new-joiner-survey).

### Logo

Your account logo is displayed in the top left corner as well as on any webforms you use.

- Click __Select new image__ to upload a file from your local drive.
- Logos are best uploaded in a square or circle crop, in a light color on a transparent background.

### Close account

If you want to permanently delete your PeopleGoal account, do so here.

__Note that this is not reversible and we will not be able to recover any account data for you.__

Change the name, subdomain and logo for your PeopleGoal account

Click on the Account icon in your navbar, then select Settings. App owners can update the account details here.

How do I change my PeopleGoal account name and logo?

Account Settings

# PeopleGoal Integration with Microsoft Teams

__We are excited to announce that PeopleGoal now integrates with MS Teams. Connecting [PeopleGoal](https://www.peoplegoal.com/product) to your Microsoft Teams account means that you can improve communication within your people processes, and you can get the best out of the two systems. PeopleGoal and MS Teams work together, allowing your people and teams to engage and communicate better.__

Enabling the PeopleGoal Bot in your MS Teams account allows you to run several PeopleGoal actions and get PeopleGoal notifications through your MS Teams platform.

This integration is available for free to all PeopleGoal customers who also have a Teams account. Here’s how to set up the integration.

---

## Connect MS Teams to PeopleGoal

__Step 1:__ Make sure your Microsoft Teams admin has allowed the use and installation of apps.

__Step 2:__ Open up Microsoft Teams (we recommend using the desktop app for this connection).

__Step 3:__ Click on the Apps tab in your Teams left navigation bar and search for PeopleGoal.

__Step 4:__ Click Add.

__Step 5:__ The PeopleGoal bot will now show up in your chat. If you’d like, you can also pin the PeopleGoal app to your lefthand navigation bar.

---

## PeopleGoal notifications

The PeopleGoal bot will notify you every time an item is created for you or an action is pending from your side. The notification will also contain a button to access the item directly in PeopleGoal.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/1OntpKgXfxhtqpQLf2Ym6Z/b9d52b857898cd95b06a1f632d812c4b/PeopleGoal_-_MS_Bot_Notifications.mp4"></source>
        </video>

---

## What can you do with the PeopleGoal Bot?

To use the PeopleGoal MS Teams bot, simply click on the __Chat__ tab and type your command in the questions field. The commands you can type in include:

### List items
This command lets you list the items you have access to. This is a great feature as at any point in time you can access all of your active PeopleGoal tasks.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/3algusQjtG0dzdJFNl757A/f9cb0158fcafbc8e004bbfa9ddfca8c6/PeopleGoal_-_MS_Bot_List_Items_1.mp4"></source>
        </video>

### List apps
Grab a full list of all the PeopleGoal apps you have access to. Remember that PeopleGoal app access is driven by permissions, so you'll only see the apps here that you have permission to access.
Click the __Go to App__ button to navigate directly to the app on PeopleGoal and create or view your items.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/RBduwFukC3uZfHELGTPVn/c9b1f83c9719a1ec25909232e518b5ed/PeopleGoal_-_MS_Bot_List__Apps.mp4"></source>
        </video>

### List teams
View all the teams you're a member of, and click __Go to team__ to access the Team page on PeopleGoal.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/3KmSxX8NxP78ZMyPhXTI5O/0472017f6aee3077d6c4e965df569586/PeopleGoal_-_MS_Bot_List__Teams.mp4"></source>
        </video>

### Create new item
This command is arguably the most useful! Create PeopleGoal items directly from MS Teams. Items are an instance of an app in PeopleGoal - for example, a new quarterly objective is an "item" within the "Objectives" app. Use this command to create a new goal, feedback or one-to-one for yourself, and enter the details into PeopleGoal.

When creating a new item you should search by the item name so we can match it with the app. For example, type in "Create new feedback" to create a [360 feedback](https://www.peoplegoal.com/guides/360-feedback-the-essential-guide) item for yourself.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/1744tmP8yjSewaYdv24Avt/2a40c54223fec3af268d82e5fbea5e48/PeopleGoal_-_MS_Bot_Create_New_Item.mp4"></source>
        </video>

### Search for ...
This command uses PeopleGoal's omni-search functionality to let you search for any users, teams or items that you have access to. Just type in "search for" and add your keyword to return relevant search results. Then click __Go to ...__ to access the area in PeopleGoal.

<video playsInline="true" muted="true" autoPlay="true" loop="true">
         <source src="https://videos.ctfassets.net/6g4s9n00xmsl/1zLTPxJxcDvcVUwyv3qYvX/7d978a04108b70dc8ffd105be974d99a/PeopleGoal_-_MS_Bot_Search.mp4"></source>
        </video>

---

And there you have it, a quick user guide to our MS Teams PeopleGoal bot! Feel free to reach out with [questions](https://www.peoplegoal.com/faqs/how-do-goals-work-on-peoplegoal) or feedback at contact@peoplegoal.com. If you don't currently have a PeopleGoal account, [book a demo](https://www.peoplegoal.com/book-a-demo) to see our MS Teams bot in action.

We are excited to announce that PeopleGoal now integrates with MS Teams. Connecting PeopleGoal to your Microsoft Teams account means that you can improve your people processes communications, and you can get the best out of the two systems.

Connecting PeopleGoal to your Microsoft Teams account means that you can improve your people processes communications.

PeopleGoal Integration with Microsoft Teams

Connect your PeopleGoal account to MS Teams

# Posts

__Use Posts to add custom content to your PeopleGoal apps, workspaces and teams pages.__

Posts are flexible and easy to use, with a lot of different applications. Add custom instructions to your app homepage to give employees more details about how to use the app, or add a cover post to a workspace to explain what's included. The most common use of posts is to publish news, updates and [policies](https://www.peoplegoal.com/resources/policies/code-of-conduct) to team members.

You can add posts in three areas of your account:
- On the app homepage
- Within a workspace
- On a Teams homepage

The post visibility is the same as the permissions you've set up for your apps, workspaces or teams. So if an employee has access to see the app/workspace, or they are a team member of the team page you've posted on, they will see the post you've added.

[Internal comms](https://www.peoplegoal.com/blog/improve-internal-communications-for-engaged-remote-employees) are crucial! When posting company-wide news, it's best to post this to your All Account default team. Only team owners can add posts to team pages, and similarly only app/workspace owners can add posts to the apps/workspaces they own.

![posts view](//images.ctfassets.net/6g4s9n00xmsl/5oAkoWqsPH2RZ6bzNoFU3z/d31021fe554e28fa651164fc97f69f21/posts_view.png)

---

## Add a post

- Select __Add__ (this button is at the bottom of your App homepage, or the top of your Workspaces/Teams page), then choose __Post__.
- A content block will be added to your page.
- Click the pencil icon in the top right-hand corner of the post to add your content.

![posts add post](//images.ctfassets.net/6g4s9n00xmsl/2qhHAABGCvgk6Y26GLX8eZ/ff76fc2167d49d49540d292344fafff9/posts_add_post.png)

### Post content and image upload

Posts have a Title, body content and an image upload. The body content is formattable to add headers, lists, links, colors and emojis. When adding a link to your content, higlight the text to turn this into your link name and paste your link into the box that appears.

- Click __Select image__ to upload a cover image for your post.
- The image will display underneath your body content, and be displayed as a cover image on the post icon if you add the post to your dashboard.
- You can only upload one image per post.

### Notify users

- Click the green __Notify all users__ button.
- This will send an in-app and email notification to all users with the post content and a link to the post location.

---

## Post settings

Posts have three settings toggles and a widget re-sizer. Switch on/off the toggles to use the settings.

![posts content](//images.ctfassets.net/6g4s9n00xmsl/4TP2W5q0XwvhSm9IeXLyEf/c1c09e239328b1c01b72a71ab004fd6f/posts_content.png)

__User display enabled:__ Shows the name of the poster and the date it was posted in the bottom left corner of the post.

__Comments enabled:__ Allows all users with access to the app/workspace/team to add comments to the post.

__Show on dashboard (company news):__ Adds the post to the [Dashboard](https://www.peoplegoal.com/blog/feature-release-new-dashboard), in the Company news section. This will only add the post to the dashboard of those users who have access to the app/workspace/team page where you've added the post. This gives a great aggregated feed of relevant posts, specific to the user's permissions across the account.

__Widget width:__ Resizes the post to 1/4, half, 3/4 or the full width of the page. If you add multiple posts to the same location you can resize posts to sit side-by-side.

---

## Delete a post

- Click the pencil icon in the top right-hand corner of your post to open the editor.
- Select __Delete__ in the bottom left, then confirm you wish to delete.
- Deleted posts are not archived and can't be restored, so be careful!

Use PeopleGoal's flexible Posts function to add content to apps, workspaces and teams pages. Share company news, instructions for how to use the apps, policies, and team status updates.

Use Posts to add content to any of your PeopleGoal apps, workspaces or teams pages. Posts allow you to share company news, policies and guidelines.

How do I create a PeopleGoal Post?

Use flexible Posts to add content to PeopleGoal apps, workspaces and teams pages.

Posts

Create impactful employee development plans in no time using PeopleGoal's app template and no-code HR workflow builder

How to create an Employee Development Plan

How to run effective Development Plans

# Create an Item

__An item is an instance of an app in [PeopleGoal](https://www.peoplegoal.com/product). An individual goal would be an example of an item created in the Goals app. The item will be owned by specific participants as it moves through the workflow states.__

Most of the time people will refer to an item by the app name (you'd create a new Goal for yourself, not a new Goal Item), but it's useful for you to know that it's called an item on the back-end - especially when it comes to creating reports.

Jump straight to:

- <a href='#create-an-item-for-yourself'>Create an Item for Yourself</a>
- <a href='#create-an-item-for-someone-else'>Create an Item for Someone Else</a>
- <a href='#view-items'>View Items</a>

<div id='create-an-item-for-yourself'></div>

---

## Create an Item for Yourself

- Open up the app you want to work with and you'll land on the app details view.
- Click __New item__, then select yourself in the __Item owner__ field. The owner is the first participant in the app worfklow.
- Your item will need a name, which will help you differentiate this item from other items you own in the same app. For example, we might called this item "2021 Annual Performance Review - Jane Smith".
- Click __Create item__ and your workflow will generate using the app template!

![360 feedback launch](//images.ctfassets.net/6g4s9n00xmsl/1nPbrZ6QBh3igtvMz53EDl/351551cef3e32490eba82a3c41dd18c8/360_feedback_launch.png)

It's not required but it is a good idea to include your own name in the item title. It will help reinforce who the overall "owner" is as the item moves through the workflow states - like when you send this Annual Performance Review to your manager to complete their assessment, it's immediately clear that the review is about you.

### Define item participants

If the app owner has predefined the app state participants then these participants will be prefilled, and you can see them on the workflow view at the top of the item.

If the participant hasn't been prefilled you'll need to select who the next participant is.

- Click the state participant placeholder icon, then click __Select user__.
- Choose your participant from the account user list, then click __Set participant__.

![peoplegoal select participant](//images.ctfassets.net/6g4s9n00xmsl/7z1e900CcYpRn317yKij78/019253409327861bc79006a640352695/peoplegoal_select_participant.png)

Note that participants all have a title! That's to make it easier to understand what their part in the workflow is. For a Goals app, the participants would be the "Goal owner" (you), and the "Goal approver" (your manager).

### Fill out the item details

This item is now in its first state - well done! As the state owner, you'll need to fill out all the required fields.

- Once you start to enter your responses you'll see a blue banner appear that says *"Please note! You have unsaved changes"*.
- Click __Save changes now__ to save your draft.
- You can return to draft items at any time. Click on the __Return__ button in the top right to exit to your App details. You'll see your item sitting in the __You__ tab, and you can click the item name to open up your draft and continue your responses.
- When you're ready, click __Submit to next state__. We'll run a validation check to ensure all required fields are filled out, and any errors will appear with a red banner for you to correct.

![peoplegoal update item](//images.ctfassets.net/6g4s9n00xmsl/31hswmtp3CzJ12HOSRAlg9/294c3d2454d3c352e59ffb193a537fd6/peoplegoal_update_item.png)

Once you've submitted your item it's sent on to the next participant to complete.

<div id='create-an-item-for-someone-else'></div>

---

## Create an Item for Someone Else

Users with the appropriate app permission can create items for other account users. Head back to the App page and click __New item__, the same as you would when creating an item for yourself.

### Create an item for individual users

- Instead of selecting yourself, choose __Select users__.
- You'll have a prefilled title that includes a placeholder for the selected username. We'd recommend you leave this as is, and allow the item owner to change the title if needed.
- In the __Select item owner__ field, type in the individual name(s) to select other account users. Then click __Create item__ and you're done!

![career development one to one launch](//images.ctfassets.net/6g4s9n00xmsl/1ycBvDFoSWBHl3cewZXeGL/b3b29e3e123aa6d5fb93d31f00318690/career_development_one_to_one_launch.png)

The selected individuals will receive a notification that an item has been created for them, and they can click straight through to complete the first state.

Note that this will create a unique item __per user__ - every state has just one participant! This will not create a "group item" or create multiple state participants.

### Create an item for teams

You can also create individual items for whole groups of users at once!

- Choose __Select team(s) of users__, then type in your team name.
- Click __Create item__ and that's it - you've created an item for every individual in the selected team.

![time tracking launch teams](//images.ctfassets.net/6g4s9n00xmsl/AZg56aDqwxBEK9eSrAuFV/f0a5efa984c0ba7650c22be1b8466c9c/time_tracking_launch_teams.png)

This function makes it super easy for HR to quickly kick off a review process for the whole account, or for department heads to send out a feedback survey to their own team members.

<div id='view-items'></div>

---

## View Items

Once your items are underway you'll want to view their progress and find items that you're a participant in.

Every time an item is moved to a state where you are the participant, you'll get a notification with a direct link to the item.

But you may also want to check up on the items of your direct reports, or see all items as an app owner.

Go back to your app page and you'll see item views are grouped in folders running down the left of the app. These folders are:

- __You__: your own items, e.g. personal OKRs you've created for yourself
- __Your Colleagues__: any items you're participating in, e.g. if you're providing a manager's assessment for a direct report's review. Colleagues are grouped by relationship types.
- __Your Teams__: items grouped by the teams in which you're a member. Note that even though you can see all teammates' names in this view, if you don't have specific permission to view their items then nothing will display under their name.
- __All Items__: all items in the app. The visibility you have here will depend on your app permissions. Owners or those with any of the "View" permissions will see all items. Managers who have Relationship permissions will see their own items and their direct reports', and users with "Create only" permission will only see their own items.

Clicking on these folders will open up the item list view, and you can click the arrows to expand more details.

Click the item title to open the full item view - if you have permission to access the item in this state.

![peoplegoal app views](//images.ctfassets.net/6g4s9n00xmsl/76pRp4Vam2kJxTPvXHrpev/6b1ad52c27a7a121f31e8f665f3c782b/peoplegoal_app_views.png)

---

Now that you've got your apps set up and you're starting to fill the app with data, you're going to want a way to analyze and track that data. We'll take you through the [reporting basics](https://www.peoplegoal.com/support/article/app-reports-and-data-view) next, and you can check out the [Become a Pro section](https://www.peoplegoal.com/support/article/reports) for the full details of creating custom reports and charts.

Create your first item within an app! Items are instances of an app that belong to the item participants defined by the app template.

Click on your workspaces icon in the navbar, then select the app name. Click "New item" to create an item for yourself or one of your relationships.

How do I create a new item on PeopleGoal?

Create an Item

# Schedules

__PeopleGoal Schedules are incredibly useful to automate your app workflows by triggering automatic items, reminders and notifications for app participants. Schedules can be set up in a few quick steps after you've polished up your app template, and once you're done you just leave them to do the work and create the performance cycle for you.__

Jump straight to:

- <a href="#create-schedule">Create a Schedule</a>

- <a href="#add-events">Add Events</a>

- <a href="#schedule-settings">Schedule Settings</a>

- <a href="#delete-schedule">Delete a Schedule</a>

<div id="create-schedule"></div>

---

## Create a Schedule

To create a new schedule:

- Open up your App homepage.
- Select __Add__ underneath your item view, then __Schedule__.
- A draft content box will appear at the top of your item view.

![peoplegoal schedules create schedule](//images.ctfassets.net/6g4s9n00xmsl/6NGczUpgLUZkEIyByUGjtU/9ffe019a68fd311d2cb82ac8974b1b3b/peoplegoal_schedules_create_schedule.png)

- Click the pencil icon in the top right to open up the content editor.

![peoplegoal schedules create content](//images.ctfassets.net/6g4s9n00xmsl/1HBOdg5nHz7BjYor507ztL/ba6c3df65f96807d854eef3b5ab07a70/peoplegoal_schedules_create_content.png)

- Enter an optional title for your schedule in the __Schedule description__ field.

![peoplegoal schedules description](//images.ctfassets.net/6g4s9n00xmsl/6CnHqaFCQfJYgkFe2trugV/5034f272cd0cbefc4800c906675e432e/peoplegoal_schedules_description.png)

<div id="add-events"></div>

---

## Add events

Events are the actions you want the schedule to trigger, and you can add as many events to a schedule as you need to! An event may be a custom reminder notification or an action to automatically create items for users within this app. You can schedule your events based on either a fixed date on the calendar, or a variable date based on one of your [profile date fields](https://www.peoplegoal.com/support/article/profile-templates).

- On the __Edit Schedule__ view, click __Add event__.
- Your event will need a __Title__ and a __Description__. These will trigger email notifications with the Title becoming your email subject and the Description becoming the email body text.
- *Tip: it's always a good idea to include a link to your app in the event description. Just copy the app URL, type your link preview text (e.g. "Click here to view the Onboarding app on PeopleGoal"), highlight this text and paste the app URL in the link that appears.*

![peoplegoal schedules event description](//images.ctfassets.net/6g4s9n00xmsl/tQgSYf18bGyVXC6TvwaaK/82cdba778e2fb4a79fdbc0ea9f3c2744/peoplegoal_schedules_event_description.png)

### Create events on a fixed date

- On the calendar, select the date on which to trigger the event.
- Type in the time in the field underneath and you're done!

![peoplegoal schedules create event](//images.ctfassets.net/6g4s9n00xmsl/vtQ7cCdtEhgqqghzWJbyd/acec7631b3596149cf74c265838d475b/peoplegoal_schedules_create_event.png)

### Create events based on profile dates

- Select the __Date based on Profile__ tab.
- Select the Profile template you want to reference (remember, you can have [many different profile templates!](https://www.peoplegoal.com/support/article/profile-templates)).
- Then select which __date element__ from the profile on which to base your event.

![peoplegoal schedules profile dates](//images.ctfassets.net/6g4s9n00xmsl/sbcPwIZT9PTAAbMXDUaLc/04034c747ba993efcf1adb2074f816ed/peoplegoal_schedules_profile_dates.png)

### Send reminders

In addition to your event notification, you can trigger reminders to go out before the event occurs. For example, you may want to remind all employees that their self-evaluations are due 5 days before the event date (due date).

You can also offset your event a number of days before/after the selected date field (whether that's a fixed date or a profile date). This is useful particularly for your Onboarding processes, where the employee start date becomes a reference for their [onboarding checklists](https://www.peoplegoal.com/support/article/how-to-create-an-employee-onboarding-process) and [new joiner surveys](https://www.peoplegoal.com/support/article/how-to-create-a-new-joiner-survey). In the case of the new joiner survey, you'd select a 30-day offset so that the survey is triggered exactly 30 days after the start date on the employee's profile.

To set up reminders:

- Type in or press up/down in the __Offset__ field. Or, leave this at '0' if needed.
- Select the number of days prior to the event you'd like to trigger a reminder. For example, if you want to remind all users 5 days before their self-evaluations are due, select '5' in this field.
- Leave this at '0' for no reminders.

![peoplegoal schedules automatically create item](//images.ctfassets.net/6g4s9n00xmsl/1SO3Dfa6RZQ4RLSMKLTRZm/96d634195355ab70ecf11a086404c2b4/peoplegoal_schedules_automatically_create_item.png)

### Automatically create items and set recurring events

Lastly, you can make our events repeat as many times as needed and set your app to automatically create items on your event day. To schedule these:

- Toggle the __Event recurs__ button on and select your frequency.
- Add an optional __End date__ on which to stop the event recurring.
- Toggle on __Automatically create new item__ to generate a draft item in the first state for all app users.
- To automatically create an item you'll need to __Select the participant__ in the workflow. For example, when setting up anniversary-based performance reviews, select your "Employee" participant to automatically create a draft self-evaluation for them.

![peoplegoal schedules automatically create item](//images.ctfassets.net/6g4s9n00xmsl/1SO3Dfa6RZQ4RLSMKLTRZm/96d634195355ab70ecf11a086404c2b4/peoplegoal_schedules_automatically_create_item.png)

__Remember to click 'Save changes' to save your updates!__

<div id="schedule-settings"></div>

---

## Schedule Settings

There are four schedule setting toggles that control how and where your schedule appears:

- __User display enabled__ switches on/off your username and date showing who created the schedule and when. Switch this off if you prefer anonymity in your apps!
- __Comments enabled__ will allow all app users to comment on this schedule.
- __Show on dashboard__ will display this schedule under the Dashboard > Company news section of any user who has permission to view this app.
- __Widget width__ controls how wide the schedule appears on your App homepage. If you've made an [instructional post](https://www.peoplegoal.com/support/article/posts) on your app it's a good idea to have these both at half-width so that they don't take up the entire App hompeage.

![peoplegoal schedules description](//images.ctfassets.net/6g4s9n00xmsl/6CnHqaFCQfJYgkFe2trugV/5034f272cd0cbefc4800c906675e432e/peoplegoal_schedules_description.png)

<div id="delete-schedule"></div>

---

## Delete a Schedule

- And finally, if ever you need to remove an event, just click the pencil icon to open up your __Event editor__.
- Select __Delete__ at the bottom of the content box, then confirm your deletion.

Use Schedules to fully automate your HR workflows! Set up custom schedules to automatically create new items on fixed dates, schedule anniversary-based items like check-ins and reviews, and create custom reminders for employees.

Use PeopleGoal schedules to automate your HR workflow with anniversary-based check-ins and reviews, custom employee reminders and fixed-date processes.

How to automate HR cycles with PeopleGoal Schedules

Use Schedules to automate your app workflows, create new items and send custom reminders on PeopleGoal.

Schedules

# Manage Users

__Account owners are responsible for adding and administering all user profiles on your PeopleGoal account. In your User menu you can invite colleagues to join the account; upload and import all employees; manage invitations and requests to join the account; and build employee database reports.__

A "user" is any individual on your PeopleGoal account, whether that's an account owner, an employee or a team lead. Every user has their own personal profile which is attached to their email address, and they will use this email address to log in to your account. You can't have more than one email address on a PeopleGoal profile (but you can belong to more than one account, either on the same or different email address).

To open your user menu, click the __Settings__ cog in the lefthand navbar, then select __Users__.

![peoplegoal users](//images.ctfassets.net/6g4s9n00xmsl/2O47R161qUWLhWIUPwo90y/88eac9173127acd47692c2cef5a5c5d4/peoplegoal_users.png)

You'll see five tabs in this menu:

<a href="#users">Users</a>

<a href="#requests">Requests</a>

<a href="#invitations">Invitations</a>

<a href="#import">Import users</a>

<a href="#data">Data</a>

<div id="users"></div>

---

## Users

This is your homepage for managing your account users, and your full list of all users. The list here is paginated, so scroll down to the bottom right and click __Show all users__ to load your entire list. On this page you'll see the Last signed in date, and there are a few different actions you can complete.

### Send user invitations

When you're ready to launch your account, you'll need to send out user invitations to all employees. Employees are not notified of any activity and are not able to access their PeopleGoal account until you've sent the invitations to them (exceptions may apply here for enterprise accounts using Single Sign-On).

- To notify an individual, click __Send invitation__ next to their user record.
- Or, to notify everyone at once, scroll to the bottom of the user list and click __Show all users__. This brings all employees onto one page and selects them all for the invitations.
- Scroll back up to the top and click the blue __Invite Users__ button.

### Make someone an account owner

- Use the Filter to search for your colleague's name.
- In the "Owner" column, toggle on the switch.
- A confirmation box will appear. Click __Promote to account owner__ to confirm.
- This employee will now have full owner access to all account settings and data.

![peoplegoal confirm account owner](//images.ctfassets.net/6g4s9n00xmsl/7t1LJxFbZFr9nX02OG6niN/bf4fca5fdfe44a997340436aa8ce647e/peoplegoal_confirm_account_owner.png)

There's no limit to the number of account owners you can have at once, and no extra charges for owner profiles. However, account owners have access to the setttings and all sensitive employee data, so it's best to limit this access to your PeopleGoal superusers only.

### Remove a profile

If an employee leaves your company, you can remove their PeopleGoal login details without deleting any of their in-app items.

- Click __Remove user__ next to the employee record.
- This user will no longer be able to access or sign in to their PeopleGoal account.
- Any items they created in the apps will still be active (e.g. feedback given to colleagues, manager assessments on reviews).

<div id="requests"></div>

---

## Requests

The Requests menu contains a list of all of the requests to join your PeopleGoal account. Anyone can request to join an account by searching for its subdomain, so all requests need to be approved by an account owner.

*See how to request to join an account in our [Create an Account section](https://www.peoplegoal.com/support/article/create-a-peoplegoal-account#join-an-account).*

- When someone requests to join your account, all account owners will be notified in-app and by email.
- Click the link or select the __Requests__ tab in your user menu.
- To view the email address for any requests, click the requestor name and their profile will open. Click back to the Requests page.
- In the __Action__ column, select to Approve or Reject this request. If approved, your colleague will be emailed a link to set their password and sign in.

![peoplegoal user requests](//images.ctfassets.net/6g4s9n00xmsl/2qJTVBj2mQx3hSzJRrxim5/379068dc14e4df347e90c8f3ec35f5a1/peoplegoal_user_requests.png)

<div id="invitations"></div>

---

## Invitations

Employees are not notified of any activity and are not able to access their [PeopleGoal](https://www.peoplegoal.com/product) account until you've sent the invitations to them (exceptions may apply here for enterprise accounts using Single Sign-On). It's easier to upload all of your user details so that you capture the data for your custom profile fields, but you can also quickly invite anyone else to join with just their email address.

### Invite a colleague by email

- Open the __Invitations__ tab on your User menu.
- Type the email in the __Send new invitation to email address__ field.
- Separate multiple emails with a comma.
- Click __Send invitation__ to invite your colleage(s).

![peoplegoal user invitations](//images.ctfassets.net/6g4s9n00xmsl/2eFlPCBirdTM0qinQH3pcL/cf06d94c40905e8182fce328b5a4b848/peoplegoal_user_invitations.png)

### Re-send invitations

There may be times when you want to re-send an invitation to someone - if they haven't accepted the initial invitation, or didn't receive it. All outgoing invitations will come from contact@peoplegoal.com, so first check your inbox to make sure you didn't miss the first invite.

- To re-send an invitation, click the __Invitations__ tab on your user menu.
- If you have > 25 invitations sent out, click __Show all invitations__ in the bottom right corner to display all.
- Find the invitation you want to re-send (CTRL/CMD + F to search for the email address) and click __Delete invitation__. You will only be able to do this if it's still pending, not accepted.
- Then invite your colleague by email using the steps above.
- The new invitation will still be attached to the same email address, so any custom profile data you may have added in your user import will still be attached to this profile. All you're doing here is re-issuing the invitation to join the account for this profile.

<div id="import"></div>

---

## Import users

The User Import Template is the easiest and quickest way to add all employees to your account. Because you can define completely custom [Profile templates](https://www.peoplegoal.com/support/article/profile-templates), your user import template will then be unique to your account and you can fill out all employee details in one upload.

- Click the __Import Users__ tab on your User menu.
- In __Step 1__, choose the profile template you want to populate (you may have more than one profile template!)
- Then click __Download import template__, and click __Next step__.
- An XLS file will be saved to your local drive to populate and upload.
- __It's very important not to change any data in the first row of this template or reorder any of your template columns! The first row contains all of the profile field IDs, and if these are removed the system can't match your employee data to the correct field.__
- Once you've populated your template in Excel, on __Step 2__ click __Next step__.
- In __Step 3__, click __Select import data__ and choose your template to upload. Then click __Upload data__.

You can see the status of your upload in the __Data imports__ menu below. Click the import to open up the details, and you'll be able to see any errors on the file.

![peoplegoal user import](//images.ctfassets.net/6g4s9n00xmsl/6Mfjqzm4KX9EzsYYXM9YCq/f2eaf09de1dab0d0d63b054f06dcf99d/peoplegoal_user_import.png)

### Relationships and Teams

Once you've imported your users, you can then go on to add their [Relationships](https://www.peoplegoal.com/support/article/relationships) and their [Teams](https://www.peoplegoal.com/support/article/teams). These are separate models from the employee profile.

<div id="data"></div>

---

## Data

The __Data__ tab is just like the Data view you have in your PeopleGoal apps. It contains a table with every single element from your employee profiles. You can use this table to [build custom reports and charts, run data exports and schedule regularly recurring reports to key stakeholders](https://www.peoplegoal.com/support/article/app-reports-and-data-view).

![peoplegoal user data](//images.ctfassets.net/6g4s9n00xmsl/3DePJwDB8cUQozOlaTCkCn/381756f660cd7eaedda709e36bb89cf0/peoplegoal_user_data.png)

The PeopleGoal Users menu is where Account Owners can add users, send invitations, update profiles and manage requests to join the account.

Account owners can select the Settings > User menu on the lefthand navbar to upload employee profiles, send invitations and manage requests to join the account.

How do I manage users on my PeopleGoal account?

Add users to your PeopleGoal account, update profiles and manage requests to join the account

Manage Users

# Web Elements

__The Web elements allow the user to upload, link and reference information from external sources to a template form. Web elements are a nice and easy way to supplement your key processes with information located outside PeopleGoal.__

For example, Web elements can be very useful when collecting information such as [contracts](https://www.peoplegoal.com/glossary/contract-for-services), CVs, and other documents during pre-onboarding for updating [employee profiles](https://www.peoplegoal.com/support/article/profile-templates).

![web elements](//images.ctfassets.net/6g4s9n00xmsl/73bx73zgEwugMJsAS46uAy/ae139df538a79e69a9cb99db40d8d9fc/web_elements.png)

There are three web element types:

- <a href='#hyperlink'>Hyperlink</a>
- <a href='#image'>Image upload</a>
- <a href='#file'>File upload</a>

<div id='#hyperlink'></div>

---

## Hyperlink

The hyperlink allows a user to add links that can be browsed directly from a template form. The user can define a hyperlink input name, i.e. element’s label, and define the content of the hyperlink.

![web hyperlink](//images.ctfassets.net/6g4s9n00xmsl/aYiaqQbj9VaxHmQ5sNbn3/88a4e9b585a811688768d31e838d1d02/web_hyperlink.png)

__Training Approval__

Hyperlinks can be very useful when requesting approval for external [training and development](https://www.peoplegoal.com/blog/how-to-kick-off-a-learning-and-development-plan-in-your-company) courses. For example, the requestor can share a hyperlink to allow the training approver to jump to an external webpage and review course, registration, and cost details before approving a training request.

![web training](//images.ctfassets.net/6g4s9n00xmsl/4A2rmKmnFhtwXM7QvJ3Uba/17870a5fa3caed82d89ffd59428071bb/web_training.png)

<div id='#image'></div>

---

## Image upload

The Image Upload element allows the user to upload an image to a template form. The user can assign an image upload name, i.e. element’s label, and define the content of the image upload for this element.

![web image upload](//images.ctfassets.net/6g4s9n00xmsl/eOYgwSs3PMCnRkPXyn736/eefb0d3e522751b776fe7a86090fe081/web_image_upload.png)

__Know Your Team Surveys__

Image uploads are a great way to enrich your processes with visual elements and establish digital connection. For example, an image upload element can be used on a “KYT” survey as an ice-breaker when introducing a new employee to the team.

![web kyt survey](//images.ctfassets.net/6g4s9n00xmsl/3bSmBwUoprSMVxenUBMYdR/270c63d537f075502be17ece1fc9a56a/web_kyt_survey.png)

__HR Frameworks__

Image uploads are very useful for visualizing frameworks relevant to your processes, such as [rating scales](https://www.peoplegoal.com/blog/performance-review-ratings-are-they-necessary), job role competencies, career stages, skills-matrix and etc. For example, you can share internal career paths along with their job level expectations relevant to different teams or departments. 

![web frameworks](//images.ctfassets.net/6g4s9n00xmsl/6UzBtBJehtdxcatq4J7fFh/b91575c8dabc973101ca9e1f543c878c/web_frameworks.png)

<div id='#file'></div>

---

## File upload

The file upload element allows the user to upload files of all formats. File format can range from portable documents to spreadsheets, PDFs and many more. The user can assign a file upload name, i.e. element’s label, and define the content of the file upload for this element.

![web file upload](//images.ctfassets.net/6g4s9n00xmsl/5tvAL0hYTg2Q0Tfr6EziAg/d12900af9abe613655fb1ae216edd2cb/web_file_upload.png)

__Goal updates__

Another great way to use the file upload element is when making updates on goals. For example, you can allow the user to attach supporting documents such as reports, plans, letters, presentations, and many more when making progress updates on goals.

![web goal updates](//images.ctfassets.net/6g4s9n00xmsl/2slI9ThZiDm3XTSogoYPPe/ce25761088415fccb08e6a386742989d/web_goal_updates.png)

__Employee Profile__

File uploads are very useful for uploading any type of personal employee information, such as Passport, National ID, Diplomas, and other sensitive documents stored on employee profiles. More importantly, the admin user can define permissions to ensure privacy by restricting access and visibility to specific individuals only.

---

With these 30+ elements you can design truly custom HR workflows that capture the data you need, in an easy to use and automated workflow. Once you understand how the elements work, you can move on to [designing custom apps](https://www.peoplegoal.com/support/article/apps) to create your own workflows, or install and edit our pre-built app templates from the [App Store](https://www.peoplegoal.com/app-store).

The Web elements allow the user to upload, link and reference information from external sources to a template form.

What do PeopleGoal web elements do?

Web Elements

# Request a Feature

Got a great idea for something you'd like to see on PeopleGoal? Let us know!

[Click here to fill out your Feature Request details](https://www.peoplegoal-v2.com/wf/598kNw) (yes, this form is built using PeopleGoal) and it'll go straight to our Customer and Development teams.

We discuss all feature requests in our monthly product meeting and anything approved for development will be added to our public Product Roadmap. [You can see the latest version of the roadmap here](https://www.notion.so/evermind/94701324b0d1486396e5d266177e6665?v=3b7eb87e97264a62b878767cf83df1fb).

![peoplegoal product roadmap](//images.ctfassets.net/6g4s9n00xmsl/2etC23xdk6oWdwaQIpVBy6/b7237f22ddc078fb5a86889765952cd8/peoplegoal_product_roadmap.png)

Got a great idea for a new PeopleGoal feature? Let us know!

Submit your feature request in the webform here. We discuss all feature requests monthly and choose which to progress to the product roadmap.

How do I request a PeopleGoal feature?

Feature Requests

# App Reports & the Data View

__Once your app processes are underway, you'll want a way to track and analyze the app data. Every single element on [PeopleGoal](https://www.peoplegoal.com/product) has a unique ID, and this is stored in the Data view on each app. This means that you can build custom reports using every data point your app, and assess the areas that are most important to your company.__

To get started with building reports, open up your app and click the __Data__ tab.

Jump straight to:

- <a href='#working-with-the-data-view'>Working with the Data View</a>
- <a href='#create-a-new-report-template'>Create a New Report Template</a>
- <a href='#run-reports'>Run Reports</a>

<div id='working-with-the-data-view'></div>

---

## Working with the Data View

Your app data is stored as a table.

Each row is an item created within an app.

Columns are sorted as:

- Item ID
- App ID (the overall app the item belongs to)
- Item Name (the custom name given to this item by the first participant)
- Current owner (the state participant currently working on the item)
- State (item state)
- Status (item status)
- Created at (date-time stamp when the item was created)
- Updated at (date-time stamp when the item was last submitted to a new state)
- Participant fields (the custom participant titles created in the app template)
- Element fields (every element created in the app template)

Your default view shows every data point in your app. You can then start to filter and sort the spreadsheet, and save these as new templates.

![peoplegoal app data](//images.ctfassets.net/6g4s9n00xmsl/4ysxZ10XdsnkpagHpnGcqv/391fd1d2ee7545f9f6305f1e0430c655/peoplegoal_app_data.png)

<div id='create-a-new-report-template'></div>

---

## Create a New Report Template

- Open up the __Data__ tab of your App.
- Click __New report template__ from the drop-down list.
- Click __Save as template__ and give your report template a name and description. Always include the App Name here as that will make the report easier to find in the overall Reports view.

![peoplegoal report template](//images.ctfassets.net/6g4s9n00xmsl/5rPG7ZEPyKqJatVBrFnYEs/151045e26ed46839834a8ed4002bdf5b/peoplegoal_report_template.png)

### Hide and sort columns

Click on a column title you want to edit. You can __hide__ the column or __sort__ by ascending or descending.

![peoplegoal report sort](//images.ctfassets.net/6g4s9n00xmsl/5YiyCyVOMNLDyFlc2ygnYn/e3865bae7cbc72bda018ec739cf38fad/peoplegoal_report_sort.png)

### Add a filter

You can also add a report-wide __Filter__ to the data. For example, you might want to look at only completed items and ignore those that have an "In progress" status.

- Click the __Filter__ tab, then __Add a new filter__.
- Select the __element__ (or column name) to filter by, then choose your __operator__.
- Type in the paramenter and that will automatically apply to the whole data table.
- Click __Save changes__ to lock in your updates.

![peoplegoal report filter](//images.ctfassets.net/6g4s9n00xmsl/1kjsyxZBJIYu8emkGzksSn/8ffacc216a2f635b447aa9098d9d7872/peoplegoal_report_filter.png)

So for our example above, we'd add a filter where "Status" (element) "contains" (operator) "Complete" (parameter), and the whole table will show only items with a completed status.

- You can add any number of filters you need to build out a completely custom report.
- To delete a filter, click the __Filters__ button and click the "x" next to the filter you want to remove.

### Set your report visibility

Toggle __Public report template__ on or off to share this report with anyone else in the app. If this button is off, only the person who created the report can view it.

App permissions will control the data visibility. So if you have "Create only" permission within this app, only your own items will show up on this report. If you have "owner" permissions you'll see all item data.

Toggle __Default report template__ on or off to make this the first report users land on when they open up the Data view.

__Always remember to save your changes! Reports do not auto-save.__

<div id='run-reports'></div>

---

## Run Reports

Now that your template is built, all the data will remain up to date any time someone creates or submits a new item. Any time you return to this report in the Data view, it will be the latest version of your app data.

You can also "run a report" at any time to both save a "point in time" copy of your report, and to export it offline.

- To run a new report, open the __Data__ tab of your app.
- Select the report you want to view from the drop-down list.
- Click __Run report__ and we'll generate a new copy of the report template.
- You'll be taken to the __Reports__ area in the lefthand navbar, where you'll see your new report file ready to download.
- You can __Open__ it to view the table in a new tab, or click __Export__ and select a __CSV__ or __Excel__ file type.
- Clicking __Delete__ will delete just this instance of the report from your __Reports__ area, not the entire report template.

![peoplegoal run report](//images.ctfassets.net/6g4s9n00xmsl/5EP2KiM9dXgMqsc4JPje9M/c7444dfa048652c305ab7a8912d7b043/peoplegoal_run_report.gif)

You've now started to build a historical record of reports that you can return to anytime by clicking __Reports__ in the navbar.

---

Of course, this is just the first step in building a custom reporting suite. In the [Become a Pro section](https://www.peoplegoal.com/support/article/reports) you'll learn how to work with charts and how to schedule your reports to be automatically sent to designated users on a regular basis.

Build a custom app report using the PeopleGoal data view.

Custom reports can be built for every PeopleGoal app using the data view. Open up your app, then click "Data" and start to build your own report.

How do I create a PeopleGoal report?

App Reports & Data View

# ADP Workforce Now integration with PeopleGoal

PeopleGoal can easily sync with your data in ADP Workforce Now, eliminating the risk of errors when loading data and allowing you to use a single data source for all your employee information.

[ADP Workforce Now](https://www.adp.com/what-we-offer/products/adp-workforce-now.aspx) is ADP's payroll solution for mid-size businesses. PeopleGoal's integration with ADP allows you to:

- Import all employee data from your ADP account into PeopleGoal
- Seamlessly add new employees to PeopleGoal
- Automatically remove employees that have been deactivated from your ADP Workforce Now account
- Synchronize any updates to employee profile information from ADP Workforce Now to PeopleGoal
- Send any information from your PeopleGoal account to ADP Workforce Now

## What are the benefits of the integration

If you are using ADP Workforce Now, we definitely recommend utilizing our integration as you will get the following benefits:

- One single data source for employee information
- Automatically add new employees to PeopleGoal through ADP Workforce Now
- Automatically disable leavers in PeopleGoal through ADP Workforce Now
- Live integration automatically updates changes to worker profiles
- Calculate salary increase based on performance in PeopleGoal and send new pay rates directly to ADP Workforce Now

> I was living in a spreadsheet nightmare and it was made all the more complex because the majority of our Principal Investigators are self-employed. It was like managing 80 different companies at once - all without the requisite technology to support me. To say it was arduous and work-intensive would be an understatement - 
__Nora Thomas, Human Resources Manager PAVIR__

## How the integration works

PeopleGoal utilizes ADP's [Workers v2 API](https://developers.adp.com/articles/api/workers-v2-api) to retrieve information from ADP Workforce Now to PeopleGoal. The Workers APIs support the management of workers in an organization. A worker is a person who performs duties and responsibilities for an organization. In that capacity, a worker fills one or more positions via a work assignment. For a given work assignment, a worker is related to the organization as an employee or contractor. The Workers APIs can be used to obtain a list of all workers in an organization and to get information about work assignments.

![PeopleGoal ADP Workforce Now integration](//images.ctfassets.net/6g4s9n00xmsl/hzylQNJxisyz80EVWRGO3/4a1ecdc604b463149ee672962005e4fb/adp-workforce-now-ss1.jpeg)

To set up the connection with your account's API you will have to share an API credential with us which usually can be generated by your Account IT admin, if you have APIs activated in your account. Most likely you will have to engage an integration specialist from ADP to generate the APIs in your account. 

Our Development team will trigger a Certificate Signing Request (CSR) with PEX certificate, in order for the ADP integration specialist to generate the API credentials:

- Client ID
- Client Certificate

The API credentials will give us access to your workers data and we will be in position to establish an automated connection between PeopleGoal and your ADP Workforce Now Account.

## Worker Profile Set Up in PeopleGoal

PeopleGoal supports custom employee profiles and you will be able to create a truly custom profile template in your account. An example of a custom profile is shown below:

![PeopleGoal ADP Workforce Now Custom Profiles](//images.ctfassets.net/6g4s9n00xmsl/5PUwD4CQxztr3aRelOMq0C/992345c8f4d032e906104ba764e7cd96/PeopleGoal_Custom_Profiles.png)

Any worker profile that is available in ADP can be imported into PeopleGoal as long as you add it in the PeopleGoal profile template. A sample of worker profile fields you can import into to PeopleGoal from ADP Workforce Now is shown below:

- First Name
- Last Name
- Preferred Name
- Date of Birth
- Address details
- Employee ID
- Gender
- Marital Status Code
- SSN
- Social Insurance Programs
- Pay rate
- Pay period hour
- Monthly rate amount
- Base remuneration
- Currency codes
- Bonus
- Position
- Position ID
- Reports to
- Team
- Department
- Supervisor
- Comp ratios
- Wage law coverage
- Work arrangement code

In addition, you can send information from PeopleGoal to your ADP Workforce Now account, some examples are:

- Performance Reviews score
- Feedback score
- Performance Reviews comments
- New Salary
- % Salary increase
- USD Salary increase
- HR notes and more

## Frequently Asked Questions

### How long does it take to complete the ADP Workforce Now with PeopleGoal?

Depending on the level of engagement from your side the full integration can be completed within a week. The first step to kick off the process is to define which worker profiles you want to have in PeopleGoal and set those up in your Account. Once that is done we will have to engage with your ADP admin to start the credential generation process.

### How frequently do you synchronize the data between ADP Workforce Now and PeopleGoal?

We can set any frequency for the data sync. We typically do it daily at 12:00 AM

### If I create a custom employee profile template and the integration is complete can I add/remove fields from the profile template?

Absolutely, once the API connection is established we can make changes to the template as needed.

### Can I import/remove workers through the integration?

Yes, user provisioning will be completed through the integration reducing the time you have to spend setting up users in PeopleGoal.

### What happens if the sync breaks and worker details are not being imported in PeopleGoal?

We have monitoring tools in place and we will be notified if the sync breaks. In that case, we will take timely action to fix the issue. We may have to engage with your ADP Workforce Now admin in case they made changes in the access level that triggered the issue.

### Do you change extra for the integration with ADP Workforce Now?

That depends on the plan you are on. Generally speaking, we charge USD 3,000 for customers that are not on the enterprise plan. 

### Does ADP charge in order to provide access to the API?

That depends on the level of access you have. In most cases there will be a one-off cost of $1000 and an annual maintenance cost of $100. However, this is something you will have to check with your ADP Workforce Now account manager.

PeopleGoal integrates with ADP Workforce Now for user provisioning and custom employee profiles.

Support Center.

Developers

Company

Solutions

Features

Learn

Subscribe to our newsletter