---
title: Core Concepts
description: "Understand the fundamental building blocks of PromptEasy."
---

PromptEasy is designed around a few core concepts that work together to provide a powerful and flexible prompt management system for your team.

### Prompts

A **Prompt** is the central piece of content in PromptEasy. It's more than just a block of text; it's a structured object containing:

- A **title** and **description** for easy identification.
- The **prompt text** itself, which can include dynamic `variables`.
- **Parameters**, which are the default values for the variables in your prompt text.
- **LLM Metadata**, allowing you to associate specific models, system messages, and settings (like temperature) with a prompt.
- **Categories** and **keywords** for organization and discoverability.

### Vaults

A **Vault** is a secure container for your prompts. Think of it as a folder or a repository. Vaults are the primary mechanism for controlling access to prompts. Each vault can be either:

- **Private**: Accessible only to members of a specific team or, in the case of a company vault, only to designated administrators.
- **Public**: Accessible to everyone within your organization.

### Teams

**Teams** are groups of users within your organization. They are the primary way to manage access to private vaults and collaborate on prompts. When you assign a user to a team, you also assign them a role that defines their permissions within that team's context.

### User Roles

There are two types of roles in PromptEasy: company-level roles and team-level roles.

#### Company-level Roles

These roles define a user's permissions across the entire organization.

- **User**: The baseline role. Can be a member of teams and contribute based on their team role.
- **Moderator**: Can manage prompts and categories in public company vaults and invite/manage other users up to the Moderator level.
- **Admin**: Has most administrative permissions, including managing teams, users, and public company vaults.
- **Superadmin**: Has full control over the entire tenant, including billing, plan management, and all administrative functions.

#### Team-level Roles

These roles define a user's permissions within a specific team.

- **Team Viewer**: Can view and use prompts within the team's vaults.
- **Team User**: Can view, use, and create new prompts, as well as suggest edits to existing prompts within the team's vaults.
- **Team Moderator**: Has all the permissions of a Team User, plus the ability to approve or reject suggestions made by others in the team. They can also invite and manage users within the team up to the Moderator level.
- **Team Admin**: Has full control over the team, its members, and its vaults.

### Suggestions

A **Suggestion** is a proposed change to an existing prompt. This workflow allows any user with the appropriate permissions to contribute improvements without directly modifying the live prompt. A user with `moderator` or `admin` rights can then review, approve, or reject the suggestion, ensuring quality and consistency.

This collaborative process is key to iteratively refining your prompts over time.