# Documentation

**URL:** https://forum.mautic.org/c/documentation/10.md

[Latest](https://forum.mautic.org/latest.md) · [Categories](https://forum.mautic.org/categories.md) · [Tags](https://forum.mautic.org/tags.md)

---

## [About the Documentation category](https://forum.mautic.org/t/about-the-documentation-category/1371)

<div class="topic-metadata">

**Author:** [@system](https://forum.mautic.org/u/system)\
**Replies:** 0\
**Last updated:** [August 12, 2019, 2:13pm UTC](https://forum.mautic.org/t/about-the-documentation-category/1371 "2019-08-12T14:13:46Z")

</div>

Interested in contributing to the Mautic documentation? Found something that needs to be fixed? Post in this category!

---

## [A/B testing in Campaign Drips](https://forum.mautic.org/t/a-b-testing-in-campaign-drips/38479)

<div class="topic-metadata">

**Author:** [@sophia85](https://forum.mautic.org/u/sophia85)\
**Replies:** 0\
**Last updated:** [August 17, 2026, 10:46am UTC](https://forum.mautic.org/t/a-b-testing-in-campaign-drips/38479 "2026-08-17T10:46:54Z")

</div>

Your software My Mautic version is: v6.0.7 Your problem My problem is: I cant figure out how to set up AB testing for campaign drips or is this only available for segment emais? currently the forum suggests this feat…

---

## [Guide: Setting Up Mautic API in Stripo](https://forum.mautic.org/t/guide-setting-up-mautic-api-in-stripo/35153)

<div class="topic-metadata">

**Author:** [@techbill](https://forum.mautic.org/u/techbill)\
**Replies:** 1\
**Last updated:** [August 4, 2025, 4:27pm UTC](https://forum.mautic.org/t/guide-setting-up-mautic-api-in-stripo/35153 "2025-08-04T16:27:31Z")

</div>

After a few trials and errors, I finally managed to get the Mautic export in Stripo working. I’m posting this guide here in hopes of saving others from some headaches. My setup is Mautic 4. Step 1: Enable API in Mautic …

---

## [Dev environment not recognized in IpRestrictMiddleware.php](https://forum.mautic.org/t/dev-environment-not-recognized-in-iprestrictmiddleware-php/34976)

<div class="topic-metadata">

**Author:** [@dominic.mayers](https://forum.mautic.org/u/dominic.mayers)\
**Replies:** 1\
**Last updated:** [February 27, 2025, 5:53pm UTC](https://forum.mautic.org/t/dev-environment-not-recognized-in-iprestrictmiddleware-php/34976 "2025-02-27T17:53:56Z")

</div>

I installed mautic in Ubuntu with nginx. I significantly adapted the nginx configuration of proffalken. I cloned the github repository and executed composer install The integration with a database using the web inst…

---

## [/api/users/new Documentation Needs Clarification](https://forum.mautic.org/t/api-users-new-documentation-needs-clarification/34613)

<div class="topic-metadata">

**Author:** [@gem](https://forum.mautic.org/u/gem)\
**Replies:** 0\
**Last updated:** [January 3, 2025, 3:22pm UTC](https://forum.mautic.org/t/api-users-new-documentation-needs-clarification/34613 "2025-01-03T15:22:42Z")

</div>

Should read something like this: Post Parameters Name Description username\* string firstName\* string lastName\* string email\* string position string role\* int timezone string onlineStatus string s…

---

## [Upgrade Mautic from v2.16.3 to v5.0.3 via docker](https://forum.mautic.org/t/upgrade-mautic-from-v2-16-3-to-v5-0-3-via-docker/31313)

<div class="topic-metadata">

**Author:** [@luk4s](https://forum.mautic.org/u/luk4s)\
**Replies:** 6\
**Last updated:** [September 17, 2024, 7:05am UTC](https://forum.mautic.org/t/upgrade-mautic-from-v2-16-3-to-v5-0-3-via-docker/31313 "2024-09-17T07:05:16Z")

</div>

I’d like to share story and my experience with mautic migration to new server with upgrade to latest version. Story: We have Mautic v2.16.3 running by our web provider, which is not willing to support instance anymore, …

---

## [Update Mautic Docker from v3 to v4](https://forum.mautic.org/t/update-mautic-docker-from-v3-to-v4/28590)

<div class="topic-metadata">

**Author:** [@irarevalo](https://forum.mautic.org/u/irarevalo)\
**Replies:** 3\
**Last updated:** [March 17, 2024, 10:57am UTC](https://forum.mautic.org/t/update-mautic-docker-from-v3-to-v4/28590 "2024-03-17T10:57:32Z")

</div>

Hello, here is a quick guide for upgrading Mautic from v3 to v4 when running on docker. First stop your mautic containers $ docker-compose down change the image tag on your docker-compose.yml and start your containe…

---

## [Mautic REST API where clause is unclear](https://forum.mautic.org/t/mautic-rest-api-where-clause-is-unclear/15450)

<div class="topic-metadata">

**Author:** [@gabe](https://forum.mautic.org/u/gabe)\
**Replies:** 1\
**Last updated:** [August 21, 2023, 3:50pm UTC](https://forum.mautic.org/t/mautic-rest-api-where-clause-is-unclear/15450 "2023-08-21T15:50:54Z")

</div>

The API Docs specifically call out the ability to send over complex selection criteria for contacts using the where clause. It says that “This design allows to add multiple conditions in the same request.” But it’s not…

---

## [REST API - Create Note, missing parameter](https://forum.mautic.org/t/rest-api-create-note-missing-parameter/9895)

<div class="topic-metadata">

**Author:** [@Eckinox](https://forum.mautic.org/u/Eckinox)\
**Replies:** 2\
**Last updated:** [January 25, 2023, 4:59pm UTC](https://forum.mautic.org/t/rest-api-create-note-missing-parameter/9895 "2023-01-25T16:59:35Z")

</div>

Hello mautic community, In the REST API -\> Create Note documentation, the “lead” parameter seems to be missing.

---

## [Mautic Filters Explained AND and OR](https://forum.mautic.org/t/mautic-filters-explained-and-and-or/26748)

<div class="topic-metadata">

**Author:** [@zero477](https://forum.mautic.org/u/zero477)\
**Replies:** 0\
**Last updated:** [January 13, 2023, 4:27pm UTC](https://forum.mautic.org/t/mautic-filters-explained-and-and-or/26748 "2023-01-13T16:27:00Z")

</div>

Your software My Mautic version is: v4.2.2 My PHP version is: 7.4.30 My Database type and version is: MariaDB 10.4 Your problem My problem is: Need help with AND and OR operators in Filters to do Segments I do not …

---

## [Documentation update](https://forum.mautic.org/t/documentation-update/25378)

<div class="topic-metadata">

**Author:** [@albertnegma](https://forum.mautic.org/u/albertnegma)\
**Replies:** 2\
**Last updated:** [September 14, 2022, 3:56pm UTC](https://forum.mautic.org/t/documentation-update/25378 "2022-09-14T15:56:42Z")

</div>

i Believe most users will agree with me on this proposal! The documentation is a bit old and most of its content is outdated and for older mautic versions! so as a new user it makes me confused, i’ve finished the setup a…

---

## [Mautic 4 Configuration File Parameters](https://forum.mautic.org/t/mautic-4-configuration-file-parameters/25233)

<div class="topic-metadata">

**Author:** [@sdoering](https://forum.mautic.org/u/sdoering)\
**Replies:** 4\
**Last updated:** [September 14, 2022, 8:16am UTC](https://forum.mautic.org/t/mautic-4-configuration-file-parameters/25233 "2022-09-14T08:16:32Z")

</div>

Is there any place (or the wish to create this) like the great Mautic configuration documentation by Leuchtfeuer but for Mautic 4? I would love to support this effort, but don’t know, if I know enough already.

---

## [What BC means in Mautic's official documentation](https://forum.mautic.org/t/what-bc-means-in-mautics-official-documentation/23840)

<div class="topic-metadata">

**Author:** [@gnumax](https://forum.mautic.org/u/gnumax)\
**Replies:** 3\
**Last updated:** [April 23, 2022, 9:47pm UTC](https://forum.mautic.org/t/what-bc-means-in-mautics-official-documentation/23840 "2022-04-23T21:47:25Z")

</div>

Hi Support, What BC means in Mautic’s official documentation Consulting information about contact tracking in the official documentation of Mautic I see that reference is made to “BC” in terms of cookies but I am not c…

---

## [Mautic official documentation login error](https://forum.mautic.org/t/mautic-official-documentation-login-error/23837)

<div class="topic-metadata">

**Author:** [@gnumax](https://forum.mautic.org/u/gnumax)\
**Replies:** 8\
**Last updated:** [April 21, 2022, 8:43pm UTC](https://forum.mautic.org/t/mautic-official-documentation-login-error/23837 "2022-04-21T20:43:28Z")

</div>

Hi Support :hugs: When I try to log in with community data in the “official” Mautic Documentation Login | Mautic to check and review, I see that it returns an error. I see that in the POST it returns the error (prob…

---

## [Composer upgrade Docs, need some work](https://forum.mautic.org/t/composer-upgrade-docs-need-some-work/22950)

<div class="topic-metadata">

**Author:** [@rdwild](https://forum.mautic.org/u/rdwild)\
**Replies:** 3\
**Last updated:** [March 8, 2022, 4:15pm UTC](https://forum.mautic.org/t/composer-upgrade-docs-need-some-work/22950 "2022-03-08T16:15:11Z")

</div>

The switch to composer docs really needs some work. I see lots of copy icons but the copied text is not complete so you can’t just copy and paste into a terminal windows in order to do the upgrade.

---

## [How to enable track\_private\_ip\_ranges in Mautic v4](https://forum.mautic.org/t/how-to-enable-track-private-ip-ranges-in-mautic-v4/22320)

<div class="topic-metadata">

**Author:** [@rwirnsberger](https://forum.mautic.org/u/rwirnsberger)\
**Replies:** 0\
**Last updated:** [January 13, 2022, 9:32am UTC](https://forum.mautic.org/t/how-to-enable-track-private-ip-ranges-in-mautic-v4/22320 "2022-01-13T09:32:19Z")

</div>

Hey, I´m using the latest version of Mautic and tried testing the tracking code within the same network. Unfortunately this does not work by default so I found this documentation. It seems that this is not longer suppo…

---

## [Builder / Save Button Bar is not visible after actually opening the builder module](https://forum.mautic.org/t/builder-save-button-bar-is-not-visible-after-actually-opening-the-builder-module/21534)

<div class="topic-metadata">

**Author:** [@dietrich](https://forum.mautic.org/u/dietrich)\
**Replies:** 0\
**Last updated:** [November 6, 2021, 1:35am UTC](https://forum.mautic.org/t/builder-save-button-bar-is-not-visible-after-actually-opening-the-builder-module/21534 "2021-11-06T01:35:22Z")

</div>

I installed Mautic on our own server and all works well so far, including a test email, but it uses the default content of the email. The reason is that when the email builder is loading, the builder button disappears wi…

---

## [Bad link here](https://forum.mautic.org/t/bad-link-here/20740)

<div class="topic-metadata">

**Author:** [@precords](https://forum.mautic.org/u/precords)\
**Replies:** 0\
**Last updated:** [September 4, 2021, 2:40pm UTC](https://forum.mautic.org/t/bad-link-here/20740 "2021-09-04T14:40:41Z")

</div>

Hello, trying to do a super basic thing. Simply in a campaign update a contact and copy from the phone field to the mobile field. Can’t figure out how to do this and this link is broken!!! Please fix asap https://…

---

## [Configuration \> Contact Settings?](https://forum.mautic.org/t/configuration-contact-settings/20253)

<div class="topic-metadata">

**Author:** [@aglyons](https://forum.mautic.org/u/aglyons)\
**Replies:** 3\
**Last updated:** [August 1, 2021, 8:11pm UTC](https://forum.mautic.org/t/configuration-contact-settings/20253 "2021-08-01T20:11:02Z")

</div>

I’ve been looking all over and cannot find anything that touches on the Configuration \> Contact Settings section. Is this a list of contact fields? Are the enabled fields on the left and disabled on the right? How are …

---

## [Mautic Command Options and Arguments](https://forum.mautic.org/t/mautic-command-options-and-arguments/18638)

<div class="topic-metadata">

**Author:** [@EJL](https://forum.mautic.org/u/EJL)\
**Replies:** 3\
**Last updated:** [July 30, 2021, 2:03pm UTC](https://forum.mautic.org/t/mautic-command-options-and-arguments/18638 "2021-07-30T14:03:54Z")

</div>

Threw together a quick and dirty list of cron/ssh commands with a list of options and the explanation. I got this info by running --help with the most commonly used commands. Update contacts in smart segments based on n…

---

## [Config options (backend) details](https://forum.mautic.org/t/config-options-backend-details/19614)

<div class="topic-metadata">

**Author:** [@jdavey.enableit](https://forum.mautic.org/u/jdavey.enableit)\
**Replies:** 1\
**Last updated:** [May 26, 2021, 9:56am UTC](https://forum.mautic.org/t/config-options-backend-details/19614 "2021-05-26T09:56:01Z")

</div>

Hi, I have searched all the documentation however I’ve been unable to find a table of all config options from local.php that lists the option, default and description. I’m mainly looking for a description for the followi…

---

## [What is the "raw payload body" in authenticity verification of webhooks?](https://forum.mautic.org/t/what-is-the-raw-payload-body-in-authenticity-verification-of-webhooks/19015)

<div class="topic-metadata">

**Author:** [@tpapaj](https://forum.mautic.org/u/tpapaj)\
**Replies:** 1\
**Last updated:** [April 27, 2021, 2:22pm UTC](https://forum.mautic.org/t/what-is-the-raw-payload-body-in-authenticity-verification-of-webhooks/19015 "2021-04-27T14:22:47Z")

</div>

Hello. I have a problem with understanding what documentation means when it mentions “(raw) payload body” during HMAC verification: https://developer.mautic.org/?json#authenticity-verification I have a raw body like t…

---

## [Cookie Use and Classification](https://forum.mautic.org/t/cookie-use-and-classification/17669)

<div class="topic-metadata">

**Author:** [@nbwpuk](https://forum.mautic.org/u/nbwpuk)\
**Replies:** 12\
**Last updated:** [February 25, 2021, 1:56pm UTC](https://forum.mautic.org/t/cookie-use-and-classification/17669 "2021-02-25T13:56:13Z")

</div>

I have the pleasant task of task of updating our cookies policy and classifying all cookies that we use. We have Mautic setup to track website visitors and current customers. We have four cookies that are being set by M…

---

## [Cookies - What does these cookies do?](https://forum.mautic.org/t/cookies-what-does-these-cookies-do/18324)

<div class="topic-metadata">

**Author:** [@maganhati](https://forum.mautic.org/u/maganhati)\
**Replies:** 0\
**Last updated:** [February 25, 2021, 1:28pm UTC](https://forum.mautic.org/t/cookies-what-does-these-cookies-do/18324 "2021-02-25T13:28:50Z")

</div>

At the company I work for, we use Mautic, but I have doubts about what each cookie means. I have not found any documentation explaining the meaning of cookies. I just found on the internet the meaning of two cookies (bu…

---

## [Reports Documentation](https://forum.mautic.org/t/reports-documentation/17734)

<div class="topic-metadata">

**Author:** [@ledzee](https://forum.mautic.org/u/ledzee)\
**Replies:** 3\
**Last updated:** [January 18, 2021, 10:17pm UTC](https://forum.mautic.org/t/reports-documentation/17734 "2021-01-18T22:17:36Z")

</div>

I think for new analysts in ACS, having explanation of all report types and data sources will be helpful over here - https://docs.mautic.org/en/reports So if I wanted to contribute documentation for the report page, wou…

---

## [Updating from 2.15.3 to 2.16.3](https://forum.mautic.org/t/updating-from-2-15-3-to-2-16-3/15359)

<div class="topic-metadata">

**Author:** [@mikew](https://forum.mautic.org/u/mikew)\
**Replies:** 0\
**Last updated:** [July 24, 2020, 12:40pm UTC](https://forum.mautic.org/t/updating-from-2-15-3-to-2-16-3/15359 "2020-07-24T12:40:46Z")

</div>

I just went through a nightmare of an upgrade from an old mautic instance 2.15.3 to 2.16.3 and came accross a number of problems along the way that maybe helpful to someone some day. So as follows: Started upgrade vi…

---

## [API: How to create a new form with the mautic API](https://forum.mautic.org/t/api-how-to-create-a-new-form-with-the-mautic-api/14023)

<div class="topic-metadata">

**Author:** [@adiux](https://forum.mautic.org/u/adiux)\
**Replies:** 0\
**Last updated:** [April 23, 2020, 2:17pm UTC](https://forum.mautic.org/t/api-how-to-create-a-new-form-with-the-mautic-api/14023 "2020-04-23T14:17:18Z")

</div>

Hi I’m trying to create a new form with the Mautic api. I use the documentation as a reference: https://developer.mautic.org/?json#create-form Does someone have an example of the JSON Payload on how to create a new for…

---

## [Bad public segment description in Mautic?](https://forum.mautic.org/t/bad-public-segment-description-in-mautic/11810)

<div class="topic-metadata">

**Author:** [@simas](https://forum.mautic.org/u/simas)\
**Replies:** 5\
**Last updated:** [November 28, 2019, 4:09pm UTC](https://forum.mautic.org/t/bad-public-segment-description-in-mautic/11810 "2019-11-28T16:09:25Z")

</div>

Not sure if I am posting to the right topic, but I find this description in segments unclear/misleading? shouldn’t it be:

---

## [Where's the contact view switch button?](https://forum.mautic.org/t/wheres-the-contact-view-switch-button/9582)

<div class="topic-metadata">

**Author:** [@daniel.andrei](https://forum.mautic.org/u/daniel.andrei)\
**Replies:** 3\
**Last updated:** [December 26, 2017, 10:40am UTC](https://forum.mautic.org/t/wheres-the-contact-view-switch-button/9582 "2017-12-26T10:40:58Z")

</div>

The official documentation states: Quote: (...) by default the list view is enabled, but you can also choose to switch to the card view (also known as grid view) which uses avatars to depict the contacts visually usin…

---

## [Outlook Add-in](https://forum.mautic.org/t/outlook-add-in/9410)

<div class="topic-metadata">

**Author:** [@mino](https://forum.mautic.org/u/mino)\
**Replies:** 2\
**Last updated:** [December 26, 2017, 10:35am UTC](https://forum.mautic.org/t/outlook-add-in/9410 "2017-12-26T10:35:37Z")

</div>

Hi Everyone, The website help section currently mentions that the Outlook add-in only works on Outlook 2016. This is not true – I have used the exact same documentation to implement on Outlook 2013 without any issue…

[Next page](https://forum.mautic.org/c/documentation/10.md?page=1)
