# Create a Wiki

### Overview

Wikis in MangoApps provide a flexible way to create, share, and collaborate on content within teams. Whether you're building from scratch or using a template, these tools offer rich features to ensure your wikis are well-organized, visually appealing, and easily accessible to your team.

***

### Creating a New Wiki

You can create a wiki from scratch or use a pre-designed template. All wikis in MangoApps **must be** created within a team. 

<figure><img src="/files/O1gky3cxeds6ohi7gRXY" alt="" width="563"><figcaption></figcaption></figure>

To get started, click the **New Wiki** button when viewing the Wikis module, whether within, team, from your Navigation menu, or from the Universal Compose button.

{% hint style="info" %}
If a wiki is created from outside a team's wiki module, you will also be prompted to select the team in which to create the wiki.
{% endhint %}

<figure><img src="/files/eXVBDG24V8y1sPQbEXmD" alt="" width="563"><figcaption></figcaption></figure>

Enter the wiki name, select the host team (if applicable), select a template for the wiki, and select the location of the wiki (either as a top-level or sub-level wiki).

{% hint style="warning" %}
Wiki titles are **case-insensitive** and **unique**. For example, if you create a wiki titled “Assistants Logs,” you cannot create another one as “assistants Logs” or “Assistants logs.”
{% endhint %}

Click **Create** when finished to navigate to the Wiki Editor.

***

### Templates & Cover Images

* **Preloaded Templates**: Each template comes with a **default cover image**.
* **Flexible Options**: Authors can remove, upload a new cover image, or select one from MangoApps.
* **Instant Updates**: Cover changes appear immediately in both preview and live mode.
* **Recommended Size**: 1920 × 180px (JPEG or PNG).

<figure><img src="/files/7VXWpziIPBP3PrGRpX8N" alt="" width="563"><figcaption></figcaption></figure>

***

### Wiki Creation Tools

MangoApps Wiki Editor offers several tools to enrich your wiki content, including embedding files, forms, surveys, and more.

<figure><img src="/files/uzNWUd2Z2ieQH6fUxVqT" alt="" width="563"><figcaption></figcaption></figure>

Some key advanced tools include:

* **Add More Items**: Insert items like files, posts, wikis, quizzes, surveys, forms, and trackers from your team.
* **Tables**: Create and style inline tables to organize information, such as project plans and due dates.
* **Code Snippets**: Add snippets for 25 programming languages to include technical content.
* **Embeds**: Embed media or content using codes from YouTube, Vimeo, and other external sources.
* **Find and Replace**: Use this feature to quickly locate and replace specific text.
* **Markdown Support**: General markdown support including AI-generated content.
* **Table of Contents**: Automatically generated based on headings, making it easy to navigate long documents. The Table of Contents is displayed on the **right-hand side** for easy navigation

***

#### Display Options for Items

When adding content boxes to your wiki, you will have a few display options.

<figure><img src="/files/z1UwK5sgarRfjVMznPxK" alt="" width="563"><figcaption></figcaption></figure>

**Bar**: Displays items in a full-width bar layout.

<figure><img src="/files/E68XjVx2zVLMmpgqUza3" alt="" width="375"><figcaption></figcaption></figure>

**Tile**: Creates clickable Tiles of your content items.

<figure><img src="/files/62Zh2R8DSYS63k5VDes5" alt="" width="375"><figcaption></figcaption></figure>

**Embed**: Embeds items, such as videos and external links, in an iFrame.

<figure><img src="/files/ym4WzDo9sXDiS0PmGkX6" alt="" width="375"><figcaption></figcaption></figure>

**Text Link**: Shows items as clickable text links.

<figure><img src="/files/inGpfFQF3ORCyMjfpcsB" alt="" width="375"><figcaption></figcaption></figure>

When ready, click **Save and Publish** to make it available to the team. Alternatively, click the **More Options** button and select **Save as Draft** to save the wiki privately.

{% hint style="danger" %}
Only the creator can view draft wikis.
{% endhint %}

{% hint style="info" %}
All team members are notified when a wiki is published.
{% endhint %}

***

### Editing a Wiki

Wikis can be edited at any time, and team members can also collaborate on wikis.&#x20;

MangoApps uses **page-locking**, so only one person can edit a page at a time. If another user tries to edit at the same time, they will receive a notification similar to:

<img src="/files/EIRJ6MfDCHHf4qg9jREG" alt="" width="470">

{% hint style="danger" %}
When locks are broken, there is a potential risk to the previous lock owner of losing their recent changes. **Breaking locks is not recommended.**
{% endhint %}

***

### **Permissions**

Team admins can control *who can create wikis/sub-wikis* under: **Edit Team > Configure Modules > Wikis > Settings > Permissions**.

Options:

* Network & Team Admins only
* Any Team Member
* Any Network User (for public teams, including non-members)Wiki\_Permissions\_Advanced\_Setti….

If you do not have permission, the **New Wiki** option will not appear.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/user-guide/wikis/create-a-wiki.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.