> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/user-guide/wikis/create-a-wiki.md).

# 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.&#x20;

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FjggRZE3QRE0nqi1rJUFM%2F10-10-2024-09-41-55.png?alt=media&amp;token=23722352-9928-4257-bebc-6ffe6229cc0e" 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="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FllS0DY1Fg39UUwriOmNE%2F10-10-2024-09-41-55.png?alt=media&amp;token=51cf8b80-f52e-4acd-8c23-f21931aa242a" 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="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FNU2yszEBvLVrFNM0ZZ4e%2F05-09-2025-12-47-56.png?alt=media&amp;token=18df482e-485d-4e0e-b62f-a9fbe7a3a7e3" 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="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FEnmTo1ZrpH2FSvEXq2pj%2F10-10-2024-01-41-59.png?alt=media&amp;token=97ea1258-4071-4d21-aa8d-377210a1e244" 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="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FtdgFNTNNK9PQIHIQ16L0%2F10-10-2024-01-47-21.png?alt=media&amp;token=4d3f6eb9-62bb-45d7-b122-768bc9ce5ff8" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FY1itzcwrNP6PaQKPlQGE%2F10-10-2024-01-51-42.png?alt=media&amp;token=fd0445e1-9e87-42e0-b7de-63895318b5bb" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FuGjdkOXAWdx6pPFlm5iv%2F10-10-2024-01-54-15.png?alt=media&amp;token=4e05975f-241a-4b96-9c44-e2b5179517d1" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FNucTib8Eum3ajp5IJm8y%2F10-10-2024-01-59-05.png?alt=media&amp;token=da3a6693-9239-4713-a67d-8f938a6bcef4" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FgBP5w33UlNAYiGDC8EhC%2F10-10-2024-02-15-06.png?alt=media&amp;token=545caefb-1ac7-4226-88d6-0f3e746f9f37" 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 %}

***

### Wiki Tabs

Wikis support multiple **tabs**, making it easy to organize related content into sections within a single wiki. Each tab includes an automatically generated outline based on its headings for quick navigation.

<figure><img src="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FgA8Fr15CZCh2c3WfZSyM%2F09-09-2026-02-34-33.png?alt=media&amp;token=db0d7302-b1ae-485d-938c-8a452c153ad5" alt="" width="563"><figcaption></figcaption></figure>

Authors can add, rename, duplicate, reorder, or delete tabs and copy direct links to individual tabs. Content is maintained separately within each tab, while **Save**, **Save & Publish**, and autosave apply across the entire wiki. The heading outline automatically updates as headings are added and reflects nested heading levels for easy navigation.

Readers can switch between tabs, jump directly to sections using the heading outline, and copy links to specific tabs.&#x20;

{% hint style="info" %}
Single-tab wikis display without tab navigation, maintaining the standard wiki experience.
{% endhint %}

All tabs are included in **search and version history**. Search results surface matching content from the relevant tab, while version comparisons identify which tabs have changed. When generating a PDF, users can export **all tabs or a specific tab**.

***

### 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="https://1570117564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKTG8tJVFEuapHmLNC%2Fuploads%2FCCtbwh8BqYRc39chq2EB%2Frjterytje.png?alt=media&amp;token=733e06b8-a996-4ea1-84d3-26da6a4e7ecb" 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.
