---
title: Configuring popups
description: "Set up what viewers see when they click a map feature. Write custom popups, add links, charts, and embeds, and build calculator popups."
---

## Start here

**[How popups work in MangoMap](/docs/configuring-popups/concepts-popups)**

How popup types, titles, formatting, and visibility fit together.

**[How to use the default popup](/docs/configuring-popups/use-default-popup)**

Show a flat list of visible attributes using the Format tab.

**[How to disable popups on a layer](/docs/configuring-popups/disable-popup)**

Turn popups off entirely on a layer.

## Build a custom popup

**[How to write a custom popup template](/docs/configuring-popups/write-custom-popup-template)**

Design a formatted popup with variables, links, images, and more.

**[How to insert attribute values into a custom popup](/docs/configuring-popups/insert-attribute-values-into-popup)**

Insert field values into popup text and titles.

**[How to show or hide content based on a feature's attributes](/docs/configuring-popups/add-conditional-content-to-popup)**

Render different popup content when a condition matches.

## Add more content

**[How to add dynamic content to a custom popup](/docs/configuring-popups/add-dynamic-content-to-popup)**

Combine equations, charts, conditionals, and action buttons.

**[How to add an image to a custom popup](/docs/configuring-popups/add-images-to-popup)**

Place static or per-feature images inside the popup.

**[How to add a table to a custom popup](/docs/configuring-popups/add-tables-to-popup)**

Align label-value pairs in a table layout.

## Actions and embeds

**[How to add a chart to a custom popup](/docs/configuring-popups/add-charts-to-popup)**

Draw a bar or pie chart from feature attributes.

**[How to add an interactive button to a custom popup](/docs/configuring-popups/add-interactive-buttons-to-popup)**

Add a button or link that opens a web page or starts an email or call.

**[How to embed an iframe in a custom popup](/docs/configuring-popups/embed-iframe-in-popup)**

Embed another web page inside the popup.

## Contact links

**[How to add an email link to a custom popup](/docs/configuring-popups/add-email-links-to-popup)**

Start an email to one address or to each feature's own address.

**[How to add a call or message link to a custom popup](/docs/configuring-popups/add-call-or-message-links-to-popup)**

Start a WhatsApp chat, Messenger chat, phone call, or text message.

## Video

**[How to embed a YouTube video in a custom popup](/docs/configuring-popups/embed-youtube-in-popup)**

Show a YouTube video directly in the popup.

**[How to embed a video file in a custom popup](/docs/configuring-popups/embed-a-video-file-in-popup)**

Play an MP4 or WebM file from your own web host.

## Calculations

**[How to add a calculated value to a custom popup](/docs/configuring-popups/add-equations-to-popup)**

Compute a per-feature value inline with equations.

**[How to use operators and functions in equations](/docs/configuring-popups/use-operators-and-functions-in-equations)**

Learn the operators and functions the equation editor accepts.

**[How to build a calculator popup](/docs/configuring-popups/build-a-calculator-popup)**

Let viewers fill in a form and compute a result.

## Reference

**[Popup tab controls](/docs/configuring-popups/popup-reference)**

Control labels, states, and defaults for the Popup tab.

**[Calculator formula syntax](/docs/configuring-popups/calculator-formula-reference)**

The full formula reference for calculator and equation content.