diff --git a/mkdocs.yml b/mkdocs.yml
index a105af6a158ff10c030d53531779e162a5f34baf..83d4d289dd4ec19a418c58bcd99de57ccbea7548 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -17,35 +17,52 @@ docs_dir: doc
 # remote_branch: gh-pages
 
 # Theme and overrides, i.e. language partial
+# https://squidfunk.github.io/mkdocs-material/creating-your-site/
 theme:
-  name: mkdocs
+  name: material
 
   # Don't include MkDocs' JavaScript
-  include_search_page: false
-  search_index_only: true
+  #include_search_page: false
+  #search_index_only: true
 
   # Default values, taken from mkdocs_theme.yml
   language: en
-  feature:
-    tabs: true
+#  feature:
+#    tabs: true
+  features:
+  - navigation.instant
+  - navigation.instant.progress
+  - navigation.tabs
+  - navigation.tabs.sticky
+  - navigation.top
+  - navigation.footer
+  - search
+  - search.highlight
+
   palette:
-    primary: 'teal'
-    accent: 'light blue'
+    primary: 'blue'
+    accent: 'teal'
+
   logo: 'images/openslice_logo.png'
 
+  icon:
+    repo: fontawesome/brands/gitlab
+
 # Copyright
 copyright: "Copyright © 2019-2023 Openslice Project"
 
 # Options
 extra:
-  search:
-    languages: "en"
+#  search:
+#    languages: "en"
   social:
-    - type: globe
-      link: http://openslice.io
-    - type: github-alt
-      link: https://github.com/openslice
-    - type: twitter
+    - type: fontawesome/classic/globe
+      link: https://osl.etsi.org/
+    - type: fontawesome/brands/gitlab
+      link: https://labs.etsi.org/rep/osl
+    - type: fontawesome/brands/linkedin
+      link: https://www.linkedin.com/company/openslice/
+    - type: fontawesome/brands/x-twitter
       link: https://twitter.com/OpensliceOSS
   version:
     provider: mike