diff --git a/docs/mdbook/src/SUMMARY.md b/docs/mdbook/src/SUMMARY.md
index b868854fd..dd8a871a8 100644
--- a/docs/mdbook/src/SUMMARY.md
+++ b/docs/mdbook/src/SUMMARY.md
@@ -14,6 +14,7 @@
- [Quickstart](./android/getting-started-guide.md)
- [Annotation: Marker](./android/annotation-guide.md)
- [Location Component](./android/location-component-guide.md)
+ - [MapOptions Guide](./android/map-options-guide.md)
- [Profiling applications that use MapLibre Native](./profiling/README.md)
- [Tracy profiling](./profiling/tracy-profiling.md)
diff --git a/docs/mdbook/src/android/map-options-guide.md b/docs/mdbook/src/android/map-options-guide.md
new file mode 100644
index 000000000..c3fdc5b16
--- /dev/null
+++ b/docs/mdbook/src/android/map-options-guide.md
@@ -0,0 +1,85 @@
+# MapLibre Configuration
+
+This guide will explain various ways to create a map.
+
+When working with maps, you likely want to configure the `MapView`.
+
+There are several ways to build a `MapView`:
+
+1. Using existing XML namespace tags for`MapView` in the layout.
+2. Creating `MapLibreMapOptions` and passing builder function values into the `MapView`.
+3. Creating a `SupportMapFragment` with the help of `MapLibreMapOptions`.
+
+Before diving into `MapView` configurations, let's understand the capabilities of both XML namespaces and `MapLibreMapOptions`.
+
+Here are some common configurations you can set:
+- Map base URI
+- Camera settings
+- Zoom level
+- Pitch
+- Gestures
+- Compass
+- Logo
+- Attribution
+- Placement of the above elements on the map and more
+
+We will explore how to achieve these configurations in XML layout and programmatically in Activity code, step by step.
+
+### `MapView` Configuration with an XML layout
+
+To configure `MapView` within an XML layout, you need to use the right namespace and provide the necessary data in the layout file.
+
+```xml
+{{#include ../../../../platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_map_options_xml.xml}}
+```
+
+This can be found in [`activity_map_options_xml.xml`](https://github.com/maplibre/maplibre-native/blob/main/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_map_fragment.xml).
+
+You can assign any other existing values to the `maplibre...` tags. Then, you only need to create `MapView` and `MapLibreMap` objects with a simple setup in the Activity.
+
+```kotlin
+{{#include ../../../../platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/options/MapOptionsXmlActivity.kt}}
+```
+
+This can be found in [`MapOptionsXmlActivity.kt`](https://github.com/maplibre/maplibre-native/blob/main/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/options/MapOptionsXmlActivity.kt).
+
+### `MapView` configuration with `MapLibreMapOptions`
+
+ Here we don't have to create MapView from XML since we want to create it programmatically.
+```xml
+{{#include ../../../../platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_map_options_xml.xml}}
+```
+
+This can be found in [`activity_map_options_runtime.xml`](https://github.com/maplibre/maplibre-native/blob/main/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_map_options_runtime.xml).
+
+A `MapLibreMapOptions` object must be created and passed to the MapView constructor. All setup is done in the Activity code:
+
+```kotlin
+{{#include ../../../../platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/options/MapOptionsRuntimeActivity.kt}}
+```
+
+This can be found in [`MapOptionsRuntimeActivity.kt`](https://github.com/maplibre/maplibre-native/blob/main/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/options/MapOptionsRuntimeActivity.kt).
+
+Finally you will see a result similar to this:
+
+
+
+