---
title: Template Groups
slug: template-groups
description: Learn how to effectively manage and organize your Kubeark templates with Template Groups in the deployment management system. This document provides comprehensive instructions on creating new Template Groups, assigning templates, and collaborating on depl
docTags: 
createdAt: 2023-07-19T12:45:55.996Z
---

:::hint{type="info"}
Each `Deployment` is subject to a limit on the number of `Templates`, which is based on the aplicable license. Each Template can have an unlimited number of `Template Versions`, however, only one version can be active at a time. The active version of the Template is the only version that can be deployed. Additionally, you have the option to update the applications of a previous version to the current active version.
:::

## Overview

Kubeark introduces **Template Groups** as a fundamental aspect of the platform's deployment management system. In the feature decomposition structure of the Kubeark platform, the `Template Groups` feature acts as the top layer. Users can simply track and manage connected deplpyments inside a single, manageable unit thanks to this high-level perspective, which offers a thorough and systematic approach to managing deployments.

`Template Groups` offer a hierarchical structure for managing and organizing Kubeark templates, which aims to help efficientize the management of deployments. By enhancing visibility and control over the deployment environment, this feature helps users monitor and maintain their installations more effectively.

An application's desired state as a collection of persistent objects in the Kubernetes ecosystem is represented by each product in the Template Groups menu. Each group is a collection of connected Kubeark deployments. A high-level view of deployments is provided by the `Template Groups` feature, which lowers the risk of errors, makes it simpler to track and manage deployments, and also helps you save time.

The `Template Groups` feature also gives users a single area from which to access and manage their deployed applications, enhancing teamwork and collaboration and allowing users to collaborate on deployments inside the same product. This feature's adaptability and contemporary design aims to provide a more consolidated and structured deployment procedure.

***

## Creating a new Template Group

**Step 1:** On the `Environments` section, under `Kubernetes`, you will find the `Templates groups.` Select `Create Template Group`

![](https://api.archbee.com/api/optimize/-uoBIPXCIMlUMvNPPrDxd/b2gG00SXpjuX9XZG2P2t4_image.png)

**Step 2:** In the group creation form, fill out the following details:

| **Argument**  | **Description**                                                                                            |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| `Name`        | Provide a unique and descriptive name for the template group. The name must contain at least 2 characters. |
| `Status`      | Choose between "Active" or "Disabled" to set the availability of the group.                                |
| `Description` | Add a brief summary of the group and its purpose to provide context for other users.                       |
| `Tags`        | Assign relevant tags to help categorize and organize the product list within the platform.                 |

![](https://api.archbee.com/api/optimize/-uoBIPXCIMlUMvNPPrDxd/obyjDNKk2_tXlkkddcIn3_templ-grp2.png)

**Step 3**: Once all of the required information has been entered, click the "Save" button to create the new Group. Upon successful creation, the Group will be added to the main list within the user's workspace.

![](https://api.archbee.com/api/optimize/-uoBIPXCIMlUMvNPPrDxd/8L1lAbCgygfGMFimTYViC_templ-grp3.png)

### Adding Templates to the Group

**Step 4**: The next step after creating a new Group is to assign Templates to it. To do this, either add a fresh Template to the list already accessible, or upload an existing Template. The Templates are made up of configuration files with all the resources needed for a particular deployment.

Kubeark offers multiple ways of adding templates to the newly created Template Group.

- **Create Template**: Using this option, you can start from scratch and define all the resources needed for a certain deployment, both mandatory and optional. This feature gives users total control over the template's setup, allowing them to tailor it to their specific needs. Please refer to the [Templates (Kubernetes)](docId\:Eud4OZB9ivS8-u3wW7-fA) section for detailed instructions on how to create a template.
- **Upload Template**: With the Upload Template option in Kubeark, you can efficiently add pre-existing templates in the form of a JSON file. This option allows you to import templates that you have previously created or saved, saving you time and effort in the process. 

![](https://api.archbee.com/api/optimize/-uoBIPXCIMlUMvNPPrDxd/WmFADieQLHZq94v2xlgnq_add-tmpl-1.png)

- **Raw**: This option allows users to manually enter and edit the template configuration in real-time, either in JSON or YAML format. This feature provides an efficient way to quickly make changes to the template configuration, especially when the desired changes are simple and require minimal effort. 

```json
//sample code block
  "name": "",
  "chart": {
    "name": "",
    "repo_url": "",
    "path": "",
    "repo": ""
  },
  "product_id": 16,
  "parent_template_id": 0,
  "owner": "sample.user",
  "description": null,
  "active": false,
  "extra_args": {},
  "public": true,
  "start_time": null,
  "default_time": "5",
  "additional_time": "0",
  "grace_time": "0",
  "tags": [],
  "environment_action": "manual"
```