---
title: "Basic repository settings"
slug: "basic-settings"
updated: 2025-11-17T22:27:04Z
published: 2025-11-17T22:27:04Z
canonical: "learn.allspice.io/basic-settings"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.allspice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Basic repository settings

## Repository Settings

The Repository Settings page allows you to configure repository behavior, access, automations, integrations, and administrative options. This guide provides an overview of each section.

## Visiting your repository settings

You can visit your repository settings by visiting your repository and clicking the Settings tab in the upper right corner ![Screenshot 2025-11-14 at 10.40.31 AM.png](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/Screenshot%202025-11-14%20at%2010.40.31%E2%80%AFAM.png)

![Screenshot 2025-11-14 at 10.44.55 AM.png](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/Screenshot%202025-11-14%20at%2010.44.55%E2%80%AFAM.png)

You can also visit hub.allspice.io/your-organization/your-reponame.

## Basic settings

## Repository Settings

The **Repository Settings** page provides configuration options for repository behavior, access controls, workflow automation, integrations, and administrative functions. This guide covers all sections in detail.

## Visiting your repository settings

You can visit your repository settings by visiting your repository and clicking the Settings tab in the upper right corner ![Screenshot 2025-11-14 at 10.40.31 AM.png](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/Screenshot%202025-11-14%20at%2010.40.31%E2%80%AFAM.png)

![Screenshot 2025-11-14 at 10.44.55 AM.png](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/Screenshot%202025-11-14%20at%2010.44.55%E2%80%AFAM.png)

You can also visit hub.allspice.io/your-organization/your-reponame.

## Basic settings

### **Repository Name**

The name of your repository determines how users identify and reference your project. A clear, descriptive name makes it easier for collaborators to understand the repository’s purpose at a glance and improves discoverability—especially in organizations with many active projects.

You can change or edit your repository name here.

### **Make Repository a Template**

Template repositories provide a reusable starting point for new projects.

Enable this option if your repo contains boilerplate files, recommended folder structures, example workflows, or standard configuration patterns. Templates help teams maintain consistency, reduce setup time, and promote best practices across multiple projects.

If enabled, the repository can serve as a [template](/v1/docs/create-a-repo-template) when creating new repositories.

### **Repository Size**

Shows total disk usage, including files, commits, and metadata.

### **Description**

Provides an overview of the project. Supports multi-line descriptions.

### **Website**

Optional project or documentation URL displayed in the repository header.

### **Repository Avatar**

A repository avatar gives your project a visual identity.

This is especially helpful when browsing large lists of repos—avatars act like quick visual anchors, making it easier to find what you're looking for. Many teams use avatars to reinforce branding, categorize repository types, or simply add personality to their workspace.

- **Choose New Avatar**
- **Update Avatar**
- **Delete Current Avatar**