mkdocs.yml

# Root config for building main page + redirects WITHOUT monorepo
# This avoids rebuilding all subsites and creating duplicate folders
# Search index is merged from versioned subsite indexes separately

theme:
    name: material
    custom_dir: overrides
    language: en
    #    features:
    #        - instant # (still experimental) feature fails to load images when folder changes
    favicon: assets/icons/favicon.ico
    logo: assets/icons/logo.svg
    logobw: assets/icons/logo-bw.svg
    palette:
        - scheme: default

    font:
        text: Circular Std
        code: Ubuntu Mono
    icon:
        repo: fontawesome/brands/github
    features:
        - navigation.tabs
        - --md-code-bg-color
        - search.share
        - search.suggest
        - navigation.tracking
        - navigation.instant
        - navigation.tabs
        - navigation.tabs.sticky
        - toc.follow
        - search.highlight

    hide:
        - navigation

markdown_extensions:
    - admonition # https://squidfunk.github.io/mkdocs-material/extensions/admonition/ (in material theme)
    - codehilite
    - meta
    # https://squidfunk.github.io/mkdocs-material/extensions/pymdown/
    - pymdownx.superfences
    - pymdownx.magiclink
    - attr_list
    - pymdownx.emoji:
          emoji_index: !!python/name:material.extensions.emoji.twemoji
          emoji_generator: !!python/name:materialx.emoji.to_svg
    - abbr
    - def_list
    - footnotes
    - md_in_html
    - toc:
          permalink: true
    - pymdownx.arithmatex:
          generic: true
    - pymdownx.betterem:
          smart_enable: all
    - pymdownx.caret
    - pymdownx.details
    - pymdownx.highlight:
          anchor_linenums: true
    - pymdownx.inlinehilite
    - pymdownx.keys
    - pymdownx.magiclink:
          repo_url_shorthand: true
          user: squidfunk
          repo: mkdocs-material
    - pymdownx.mark
    - pymdownx.smartsymbols
    - pymdownx.superfences:
          custom_fences:
              - name: mermaid
                class: mermaid
                format: !!python/name:pymdownx.superfences.fence_code_format
    - pymdownx.tabbed:
          alternate_style: true
    - pymdownx.tasklist:
          custom_checkbox: true
    - pymdownx.tilde
    - pymdownx.snippets

# NO monorepo plugin - we don't want to rebuild all subsites
plugins:
    # - monorepo  # REMOVED - subsites are built separately with mike
    - search: # necessary for search to work
    #   - autolinks
    - awesome-pages:
    #       strict: false
    - git-revision-date-localized
    - minify
    #       minify_html: true
    - redirects:
          redirect_maps:
              "products/products-virto3-versions.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/virto3-products-versions"
              "license.md": "https://virtocommerce.com/open-source-license"
              "support.md": "https://help.virtocommerce.com/support/home"
              "vc-quickstart.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Getting-Started/Installation-Guide/windows"
              "architecture-center/B2B-multiregional.md": "https://docs.virtocommerce.org/platform/user-guide/latest/multiregional-ecommerce"
              "developer-guide/create-new-module-advanced.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/create-new-module-from-scratch"
              "developer-guide/create-new-module.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/creating-custom-module"
              "developer-guide/deploy-from-source-code.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/debugging"
              "developer-guide/deploy-module-from-source-code.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/deploy-module-from-source-code"
              "developer-guide/global-tools.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/CLI-tools/overview"
              "developer-guide/logging.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Logging/overview"
              "developer-guide/modules-development-via-docker.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/docker-modules-development"
              "developer-guide/swagger-endpoints.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/swagger-api"
              "developer-guide/user-manager.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/extensions/extending-usermanager-and-rolemanager"
              "developer-guide/using-autorest-with-v3.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/generating-c-sharp-client"
              "fundamentals/architecture-reference.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Back-End-Architecture/02-conceptual-overview"
              "fundamentals/db-agnostic.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Persistence/DB-Agnostic/overview"
              "fundamentals/essential-caching.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Caching/01-overview"
              "fundamentals/essential-modularity.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Modularity/01-overview"
              "fundamentals/make-secure-webapi.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/security-in-depth"
              "fundamentals/scalability.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Scalability/overview"
              "fundamentals/search.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Indexed-Search/overview"
              "fundamentals/extensibility/blade-toolbar.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/blade-toolbar"
              "fundamentals/extensibility/blades-and-navigation.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/blades-and-navigation"
              "fundamentals/extensibility/extending-authorization-policies.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/extensions/extending-authorization-policies"
              "fundamentals/extensibility/extending-domain-models.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/extending-domain-models"
              "fundamentals/extensibility/extending-grid-columns.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/extending-grid-columns"
              "fundamentals/extensibility/extending-main-menu.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/extending-main-menu"
              "fundamentals/extensibility/extending-using-events.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Event-Driven-Development/using-domain-events"
              "fundamentals/extensibility/metaform.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/metaform"
              "fundamentals/extensibility/new-payment-method-registration.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Payments/new-payment-method-registration"
              "fundamentals/extensibility/new-shipping-method-registration.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Shipments/new-shipping-method-registration"
              "fundamentals/extensibility/new-tax-provider-registration.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Taxes/new-tax-provider-registration"
              "fundamentals/extensibility/overview.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Extensibility/overview"
              "fundamentals/extensibility/style-guide.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/style-guide"
              "fundamentals/extensibility/ui-scroll-directive.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/ui-scroll-directive"
              "fundamentals/extensibility/using-dynamic-properties.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Dynamic-Properties/overview"
              "fundamentals/extensibility/widgets.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/Extensibility-Points/widgets"
              "getting-started/connect-storefront-to-platform-v3.md": "https://docs.virtocommerce.org/storefront/developer-guide/latest/deployment"
              "getting-started/deploy-from-precompiled-binaries-MacOS.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Getting-Started/Installation-Guide/macOS"
              "getting-started/deploy-from-precompiled-binaries-azure.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/deploy-platform-on-azure"
              "getting-started/deploy-from-precompiled-binaries-linux.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Getting-Started/Installation-Guide/linux"
              "getting-started/deploy-from-precompiled-binaries-windows.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Getting-Started/Installation-Guide/windows"
              "getting-started/email-sending-settings.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Notifications/overview"
              "getting-started/lessons.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/overview"
              "getting-started/lessons/lesson1.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Getting-Started/Installation-Guide/windows"
              "getting-started/lessons/lesson2.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/import-products-to-catalog"
              "getting-started/lessons/lesson3.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/creating-custom-module"
              "getting-started/lessons/lesson4.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/build-platform-manager-ui"
              "modules/assets.md": "https://docs.virtocommerce.org/platform/user-guide/latest/assets/managing-assets"
              "modules/azure-ad.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/configuring-and-managing-azure-auth"
              "modules/azureblob-assets.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Configuration-Reference/appsettingsjson/#__tabbed_2_2"
              "modules/cart.md": "https://docs.virtocommerce.org/platform/user-guide/latest/cart/overview"
              "modules/catalog.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/overview"
              "modules/catalog/add-new-catalog.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/add-new-catalog/#physical-catalogs"
              "modules/catalog/add-virtual-catalog.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/add-new-catalog/#virtual-catalogs"
              "modules/catalog/catalog-search.md": "https://docs.virtocommerce.org/platform/user-guide/latest/search"
              "modules/catalog/glossary.md": "https://docs.virtocommerce.org/platform/user-guide/latest/search"
              "modules/catalog/managing-categories.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-categories"
              "modules/catalog/managing-products.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-products"
              "modules/catalog/managing-productt-variations.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-product-variations"
              "modules/catalog/managing-properties.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-properties"
              "modules/catalog/managing-search-index.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-search-index"
              "modules/catalog/product-indexing.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/product-indexing"
              "modules/catalog/search-engine-architecture-details.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Indexed-Search/overview"
              "modules/catalog/view-catalogs-and-physical-items.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/add-new-catalog/#view-catalogs"
              "modules/catalog/view-product-variations.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-product-variations/#view-product-variations"
              "modules/catalog/view-properties.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog/managing-properties/#view-properties"
              "modules/catalog-personalization.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog-personalization/settings"
              "modules/catalog-publishing.md": "https://docs.virtocommerce.org/platform/user-guide/latest/catalog-publishing/overview"
              "modules/content.md": "https://docs.virtocommerce.org/platform/user-guide/latest/content/overview"
              "modules/content/pages-blogs-management.md": "https://docs.virtocommerce.org/platform/user-guide/latest/content/managing-pages"
              "modules/content/theme-management.md": "https://docs.virtocommerce.org/platform/user-guide/latest/content/managing-themes"
              "modules/contract.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contracts/overview"
              "modules/contract/XAPI.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Profile/Queries/contact"
              "modules/core/How-to%20override%20rounding%20policy.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/overriding-rounding-policy"
              "modules/customer.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contracts/managing-contract-customers"
              "modules/customer/advanced-filter.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/filtering-options"
              "modules/customer/create-and-manage-employee.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/managing-contacts"
              "modules/customer/create-and-manage-organization.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/managing-contacts"
              "modules/customer/manage-contacts.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/managing-contacts"
              "modules/customer/manage-vendors.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/managing-contacts"
              "modules/customer/view-organization-details.md": "https://docs.virtocommerce.org/platform/user-guide/latest/contacts/managing-contacts"
              "modules/customer-export-import/Index.md": "https://docs.virtocommerce.org/platform/user-guide/latest/customer-export-import/overview"
              "modules/customer-review.md": "https://docs.virtocommerce.org/platform/user-guide/latest/rating-reviews/overview"
              "modules/customer-review/rest-api.md": "https://docs.virtocommerce.org/platform/user-guide/latest/rating-reviews/rest-api"
              "modules/dynamic-associations.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/dynamic-associations-overview"
              "modules/dynamic-associations/rest-api.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/dynamic-associations-restapi"
              "modules/elastic-app-search/eas-setup-guide.md": "https://docs.virtocommerce.org/platform/user-guide/latest/elastic-app-search/overview"
              "modules/elastic-search.md": "https://docs.virtocommerce.org/platform/user-guide/latest/elastic-search/overview"
              "modules/elastic-search/blue-green-indexation.md": "https://docs.virtocommerce.org/platform/user-guide/latest/search/managing-search/#blue-green-indexing"
              "modules/event-bus.md": "https://docs.virtocommerce.org/platform/user-guide/latest/event-bus/overview"
              "modules/experience-api.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI"
              "modules/experience-api/application-insights-integration.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/troubleshooting"
              "modules/experience-api/filter-syntax.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Catalog/queries/products"
              "modules/experience-api/getting-started.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/getting-started"
              "modules/experience-api/x-api-extensions.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/x-api-extensions"
              "modules/experience-api/x-catalog-reference.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Catalog/overview"
              "modules/experience-api/x-purchase-cart-reference.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Cart/overview"
              "modules/experience-api/x-purchase-order-reference.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Order/overview"
              "modules/export.md": "https://docs.virtocommerce.org/platform/user-guide/latest/generic-export/overview"
              "modules/export/advanced-filter.md": "https://docs.virtocommerce.org/platform/user-guide/latest/generic-export/advanced-filtering"
              "modules/gdpr/gdpr.md": "https://docs.virtocommerce.org/platform/user-guide/latest/gdpr/overview"
              "modules/google-ecommerce-analytics.md": "https://docs.virtocommerce.org/platform/user-guide/latest/integrations/google-analytics/overview"
              "modules/hotjar.md": "https://docs.virtocommerce.org/platform/user-guide/latest/integrations/hotjar/overview"
              "modules/image-tools.md": "https://docs.virtocommerce.org/platform/user-guide/latest/thumbnails/overview"
              "modules/inventory.md": "https://docs.virtocommerce.org/platform/user-guide/latest/inventory/overview"
              "modules/inventory/manage-fullfilment.md": "https://docs.virtocommerce.org/platform/user-guide/latest/inventory/managing-fulfillment-centers"
              "modules/marketing.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/overview"
              "modules/marketing/combine-active-promotions.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/combining-active-promotions"
              "modules/marketing/manage-content-items.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/managing-content-items/?h=content+items"
              "modules/marketing/manage-content-placeholders.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/managing-content-placeholders"
              "modules/marketing/manage-content-publishing.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/managing-published-content"
              "modules/marketing/manage-promotions.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/managing-promotions"
              "modules/marketing/promotion-rules.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/promotion-rules"
              "modules/marketing/publishing-conditions.md": "https://docs.virtocommerce.org/platform/user-guide/latest/marketing/publish-conditions"
              "modules/marketing-experience-api.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Marketing/overview"
              "modules/native-payment-methods/working-guide.md": "https://docs.virtocommerce.org/platform/user-guide/latest/native-payment-methods/overview"
              "modules/notification.md": "https://docs.virtocommerce.org/platform/user-guide/latest/notifications/overview"
              "modules/notification/tech-doc.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Notifications/registering-new-notification-type"
              "modules/notification/tips-and-tricks-for-creating-email-templates.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Notifications/notification-templates"
              "modules/order.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/overview"
              "modules/order/How-to%20extend%20validation.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/x-api-extensions/#extend-validation-logic-replace-validators"
              "modules/order/order-details.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/main-objects"
              "modules/order/order-documents.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/managing-documents"
              "modules/order/order-module-notification-types.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/notifications"
              "modules/order/order-widgets.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/main-objects"
              "modules/order/roles-and-permissions-scenarios.md": "https://docs.virtocommerce.org/platform/user-guide/latest/order-management/permissions"
              "modules/payment.md": "https://docs.virtocommerce.org/platform/user-guide/latest/payment/overview"
              "modules/price-export-import.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/export-functionality"
              "modules/pricing.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/overview"
              "modules/pricing/add-new-assignment.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/adding-new-assignment"
              "modules/pricing/add-prices-to-products.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/creating-new-price-list/#add-and-edit-product-prices"
              "modules/pricing/add-products-to-the-new-price-list.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/creating-new-price-list/#add-products-to-price-list"
              "modules/pricing/create-new-price-list.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/creating-new-price-list/#create-new-price-list"
              "modules/pricing/export-functionality.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/export-functionality"
              "modules/pricing/managing-pricing-module-settings.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/managing-pricing-module-settings"
              "modules/pricing/troubleshooting-guide.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/troubleshooting-guide"
              "modules/pricing/view-price-list-via-catalog-module.md": "https://docs.virtocommerce.org/platform/user-guide/latest/pricing/viewing-price-list-in-catalog"
              "modules/profile-experience-api.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Profile/overview"
              "modules/quote.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/Quote/overview"
              "modules/return/return-module-guide.md": "https://docs.virtocommerce.org/platform/user-guide/latest/return/overview"
              "modules/shipping.md": "https://docs.virtocommerce.org/platform/user-guide/latest/shipping/overview"
              "modules/shipstation.md": "https://docs.virtocommerce.org/platform/user-guide/latest/shipstation/overview"
              "modules/sitemaps.md": "https://docs.virtocommerce.org/platform/user-guide/latest/sitemaps/overview"
              "modules/store.md": "https://docs.virtocommerce.org/platform/user-guide/latest/store/overview"
              "modules/store/add-new-store.md": "https://docs.virtocommerce.org/platform/user-guide/latest/store/adding-new-store"
              "modules/store/edit-store-details.md": "https://docs.virtocommerce.org/platform/user-guide/latest/store/configuring-store"
              "modules/store/edit-widgets.md": "https://docs.virtocommerce.org/platform/user-guide/latest/store/configuring-store"
              "modules/subscription.md": "https://docs.virtocommerce.org/platform/user-guide/latest/subscriptions/overview"
              "modules/tax.md": "https://docs.virtocommerce.org/platform/user-guide/latest/tax/overview"
              "modules/webhooks.md": "https://docs.virtocommerce.org/platform/user-guide/latest/webhooks/overview"
              "products/v3-2020-Q3.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2020-Q3"
              "products/v3-2021-Q1.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2021-Q1"
              "products/v3-2021-Q3.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2021-Q3"
              "products/v3-2022-Q1.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2022-Q1"
              "products/v3-2022-Q2.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2022-Q2"
              "products/v3-2022-Q3.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2022-Q3"
              "products/v3-2022-Q4.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2022-Q4"
              "products/v3-2023-S5.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2023-S5"
              "products/v3-2023-S6.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2023-S6"
              "products/v3-2024-S7.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2024-S7"
              "products/v3-2024-S8.md": "https://docs.virtocommerce.org/platform/user-guide/latest/versions/v3-2024-S8"
              "release-information/update-to-version-3-800/update-platform-and-modules-to-3-800.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/upgrading-to-net8"
              "techniques/add-new-sso-provider.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/extensions/adding-new-sso-provider"
              "techniques/authentication-with-azure-ad.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Security/configuring-and-managing-azure-auth"
              "techniques/countries-management.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Platform-Manager/localization"
              "techniques/debugging-without-source-code.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/debugging"
              "techniques/exposing-polymorphic-types-swagger.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/type-inheritance-support-in-swagger"
              "techniques/extend-DB-model.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/Tutorials/extending-database-model"
              "techniques/generate-pdf-file.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/generating-pdfs"
              "techniques/healthchecks.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/health-checks"
              "techniques/how-scale-out-platform-on-azure.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Fundamentals/Scalability/scalability-options"
              "techniques/how-to-run-platform-on-azure-functions.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/deploy-platform-on-azure"
              "techniques/implementing-authorization-mechanism-using-jwt.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/authorization-using-jwt"
              "techniques/sharing-bearer-tokens-across-platform-instances.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/sharing-bearer-tokens"
              "techniques/user-email-verification.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/user-email-verification"
              "user-guide/assets-function.md": "https://docs.virtocommerce.org/platform/user-guide/latest/assets/overview"
              "user-guide/configuration-settings.md": "https://docs.virtocommerce.org/platform/developer-guide/latest/Configuration-Reference/appsettingsjson"
              "user-guide/getting-started.md": "https://docs.virtocommerce.org/platform/user-guide/latest/getting-started"
              "user-guide/login-on-behalf.md": "https://docs.virtocommerce.org/platform/user-guide/latest/security/login-on-behalf"
              "user-guide/modules.md": "https://docs.virtocommerce.org/platform/user-guide/latest/modules-installation"
              "user-guide/security.md": "https://docs.virtocommerce.org/platform/user-guide/latest/security/roles-and-permissions"
              "user-guide/user-profile.md": "https://docs.virtocommerce.org/platform/user-guide/latest/user-profile"
              "release-information/whats-new.md": "https://www.virtocommerce.org/c/news-digest"
    - include-markdown

# Project information
extra_site_name: Documentation
site_name: docs
site_description: Documentation portal for enterprise-level Microsoft .NET ecommerce platform Virto Commerce.
site_author: Virto Commerce
site_url: https://docs.virtocommerce.org

# Repository
repo_name: VirtoCommerce/vc-platform
repo_url: https://github.com/VirtoCommerce/vc-platform
edit_uri: edit/dev/docs/

# Copyright
copyright: Copyright © 2026. All rights reserved.

# Simple nav WITHOUT !include directives (no monorepo)
nav:
    - Home: index.md

extra:
    root_url: https://docs.virtocommerce.org
    homepage: /
    social:
        - icon: fontawesome/brands/github
          link: https://github.com/VirtoCommerce
        - icon: fontawesome/brands/facebook
          link: https://facebook.com/VirtoCommerce
        - icon: fontawesome/brands/twitter
          link: https://twitter.com/virtocommerce?lang=en
        - icon: fontawesome/brands/instagram
          link: google.com
        - icon: fontawesome/brands/linkedin
          link: https://www.linkedin.com/company/virto-commerce/
        - icon: fontawesome/brands/youtube
          link: https://www.youtube.com/c/Virtocommerce/videos
    search:
        icon: assets/icons/search.svg
    rss:
        icon: assets/icons/rss.svg
    footer_links:
        - title: Support
          url: https://help.virtocommerce.com/support/home
        - title: Community
          url: https://www.virtocommerce.org/
        - title: FAQ
          url: https://www.virtocommerce.org/faq
        - title: Release Notes
          url: https://www.virtocommerce.org/c/news-digest/
    main_page:
        release_notes:
            - title: May 2026
              link: https://www.virtocommerce.org/t/virto-s-release-notes-may-2026/849
              type: Release Notes
              date: May 1, 2026
            - title: April 2026
              link: https://www.virtocommerce.org/t/virto-s-release-notes-april-2026/847
              type: Release Notes
              date: April 1, 2026
            - title: March 2026
              link: https://www.virtocommerce.org/t/virto-s-release-notes-march-2026/839
              type: Release Notes
              date: March 2, 2026
            - title: February 2026
              link: https://www.virtocommerce.org/t/virto-s-release-notes-february-2026/834
              type: Release Notes
              date: February 2, 2026
            - title: January 2026
              link: https://www.virtocommerce.org/t/virto-s-release-notes-january-2026/821
              type: Release Notes
              date: January 1, 2026
            - title: December 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-december-2025/818
              type: Release Notes
              date: December 2, 2025
            - title: November 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-november-2025/814
              type: Release Notes
              date: November 6, 2025
            - title: October 2025
              link: https://www.virtocommerce.org/t/virtos-release-notes-october-2025/807
              type: Release Notes
              date: October 7, 2025
            - title: September 2025
              link: https://www.virtocommerce.org/t/virtos-release-notes-september-2025/805
              type: Release Notes
              date: September 2, 2025
            - title: August 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-august-2025/801
              type: Release Notes
              date: August 1, 2025
            - title: July 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-july-2025/798
              type: Release Notes
              date: July 7, 2025
            - title: June 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-june-2025/796
              type: Release Notes
              date: June 4, 2025
            - title: May 2025
              link: https://www.virtocommerce.org/t/virtos-release-notes-may-2025/778
              type: Release Notes
              date: May 1, 2025
            - title: April 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-april-2025/769
              type: Release Notes
              date: April 2, 2025
            - title: March 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-march-2025/767
              type: Release Notes
              date: March 3, 2025
            - title: February 2025
              link: https://www.virtocommerce.org/t/virtos-release-notes-february-2025/760
              type: Release Notes
              date: February 3, 2025
            - title: January 2025
              link: https://www.virtocommerce.org/t/virto-s-release-notes-january-2025/755
              type: Release Notes
              date: January 1, 2025

        top_cards:
            # -   title: Architect
            #     icon: assets/icons/package.svg
            #     description: I need to build the platform's architecture or learn how I can do that.
            #     link: https://docs.virtocommerce.org/architecture-center/B2B-multiregional/
            - title: Storefront
              icon: assets/icons/person.svg
              description: Build and personalize your online store for engaging shopping experiences
              link: storefront
            - title: Platform
              icon: assets/icons/code-square.svg
              description: Explore the Virto Commerce Platform, a solution designed to efficiently manage and scale your entire e-commerce ecosystem
              link: platform
            - title: Marketplace
              icon: assets/icons/code-square.svg
              description: Create and manage online marketplaces, fostering increased revenue and a broader customer base
              link: marketplace

        documentation:
            - title: Composable Commerce
              image: assets/images/platform.png
              link: platform
              topdescription: Guides and tools for building, customizing, and deploying a flexible commerce solution
              description:
                  - title: Platform
                    link: platform
                  - title: Marketplace
                    link: marketplace
                  - title: CLI tools
                    link: platform/developer-guide/latest/CLI-tools/overview
            - title: Frontend
              image: assets/images/storefront.png
              link: storefront
              topdescription: Tools and workflows designed to enhance customer-facing experiences
              description:
                  - title: Frontend Application
                    link: storefront
                  - title: VC-Shell
                    link: platform/developer-guide/latest/custom-apps-development/overview

            # - title: Marketplace
            #   description: Create and manage online marketplaces, fostering increased revenue and a broader customer base
            #   image: assets/images/marketplace.png
            #   link: marketplace
            # - title: Custom Apps
            #   description: Create tailored solutions within the VC-Shell
            #   image: assets/images/custom-apps.png
            #   link: platform/developer-guide/custom-apps-development/overview
            # - title: CLI Tools
            #   description: Streamline development with command-line interface tools tailored for efficient development workflows
            #   image: assets/images/cli-tools.png
            #   link: platform/developer-guide/CLI-tools/overview/

        link_cards:
            - title: Contact support
              icon: assets/icons/contact-support.svg
              link: https://help.virtocommerce.com/support/home
              outlineColor: "#EA534A"
            - title: Community
              icon: assets/icons/community.svg
              link: https://www.virtocommerce.org/
              outlineColor: "#EA534A"
            - title: GitHub
              icon: assets/icons/github-outline.svg
              link: https://github.com/VirtoCommerce
              outlineColor: "#FF9162"
            - title: Blog
              icon: assets/icons/blog.svg
              link: https://virtocommerce.com/blog
              outlineColor: "#FF9162"
            - title: Versions
              icon: assets/icons/version-icon.svg
              link: https://github.com/VirtoCommerce/vc-platform/tree/dev/docs/products
              outlineColor: "#FF9162"
    all_topics:
        megamenu:
            - iconSrc: assets/icons/all-products.svg
              title: All Products
              opened: true
              subMenu:
                  - title: Platform
                    content:
                        - title: User Guide
                          links:
                              - title: Getting Started
                                url: /platform/user-guide/latest/getting-started
                              - title: User Documentation
                                url: /platform/user-guide/latest/
                        - title: Developer Guide
                          links:
                              - title: Installation Guide
                                url: /platform/developer-guide/latest/Getting-Started/Installation-Guide/windows
                              - title: Architecture Overview
                                url: /platform/developer-guide/latest/Back-End-Architecture/02-conceptual-overview
                              - title: Extensibility
                                url: /platform/developer-guide/latest/Extensibility/overview
                              - title: Configuration Reference
                                url: /platform/developer-guide/latest/Configuration-Reference/appsettingsjson
                              - title: Tutorials and How-tos
                                url: /platform/developer-guide/latest/Tutorials-and-How-tos/overview
                        - title: API Reference
                          links:
                              - title: REST API Reference
                                url: https://virtostart-demo-admin.govirto.com/docs/index.html
                              - title: GraphQL API Reference
                                url: /platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/getting-started
                  - title: Frontend
                    content:
                        - title: User Guide
                          links:
                              - title: Getting Started
                                url: https://youtu.be/xsnds1QYuC0
                              - title: User Documentation
                                url: /storefront/user-guide/latest/
                              - title: Public Demo
                                url: https://virtostart-demo-store.govirto.com/
                        - title: Developer Guide
                          links:
                              - title: Getting Started
                                url: /storefront/developer-guide/latest
                              - title: Architecture
                                url: /storefront/developer-guide/latest/architecture
                              - title: Deployment
                                url: /storefront/developer-guide/latest/deployment
                              - title: Integrations
                                url: /storefront/developer-guide/latest/integrations/prerender_io
                  - title: Marketplace
                    content:
                        - title: User Guide
                          links:
                              - title: Operator Portal
                                url: /marketplace/user-guide/latest/Operator-portal/overview
                              - title: Vendor Portal
                                url: /marketplace/user-guide/latest/Vendor-portal/overview
                        - title: Developer Guide
                          links:
                              - title: State Machine Module
                                url: /marketplace/developer-guide/latest/state-machine-module/overview
                  - title: VC-Shell
                    content:
                        - title: Developer Guide
                          links:
                              - title: Overview
                                url: /platform/developer-guide/latest/custom-apps-development/vc-shell/vc-shell-overview
                              - title: Getting Started
                                url: /platform/developer-guide/latest/custom-apps-development/vc-shell/Getting-started/creating-first-custom-app/
                              - title: Connecting to Platform
                                url: /platform/developer-guide/latest/custom-apps-development/vc-shell/How-tos/Connecting-to-Platform/
                  - title: Deployment on Virto Cloud
                    content:
                        - links:
                              - title: Deploy Platform and Frontend on Virto Cloud
                                url: /platform/deployment-on-cloud/latest/deploy-on-virto-cloud/
                              - title: Create Environment via CLI and VC Build
                                url: /platform/deployment-on-cloud/latest/create-environment-via-cli-and-vc-build/
                              - title: Create and Configure Catalog
                                url: /platform/deployment-on-cloud/latest/catalog-creation/
                              - title: Create and Configure Store
                                url: /platform/deployment-on-cloud/latest/store-configuration/
            - iconSrc: assets/icons/getting-started.svg
              title: Getting Started
              content:
                  - title: Platform
                    links:
                        - title: Developer Getting Started
                          url: /platform/developer-guide/latest/Getting-Started/Installation-Guide/windows
                        - title: Manager Getting Started
                          url: /platform/user-guide/latest/getting-started
                  - title: Frontend Application
                    links:
                        - title: Developer Getting Started
                          url: /storefront/developer-guide/latest/
                        - title: User Getting Started
                          url: /storefront/user-guide/latest/
                  - title: VC-Shell
                    links:
                        - title: Developer Getting Started
                          url: /platform/developer-guide/latest/custom-apps-development/vc-shell/Getting-started/creating-first-custom-app
            - iconSrc: assets/icons/graphql.svg
              title: APIs
              content:
                  - title: REST API
                    url: https://virtostart-demo-admin.govirto.com/docs/index.html
                  - title: GraphQL API
                    url: /platform/developer-guide/latest/GraphQL-Storefront-API-Reference-xAPI/getting-started
            - iconSrc: assets/icons/video-tutorials.svg
              title: Video Tutorials
              url: https://www.youtube.com/c/VirtoCommerce
              external: true
            - iconSrc: assets/icons/fire.svg
              title: Upgrading to .NET10
              url: /platform/developer-guide/latest/Tutorials-and-How-tos/How-tos/upgrading-to-dot-net-10
        footer:
            - iconSrc: "assets/icons/release-notes.svg"
              title: "Release Notes"
              url: "https://www.virtocommerce.org/c/news-digest/"
            - iconSrc: "assets/icons/support.svg"
              title: "Support"
              url: "https://help.virtocommerce.com/support/home"
            - iconSrc: "assets/icons/github.svg"
              title: "GitHub"
              url: "https://github.com/VirtoCommerce"
extra_javascript:
    - assets/scripts/version-redirect.js
    - assets/scripts/version-selector-handler.js
    - assets/scripts/scripts-loader.js
    - assets/scripts/scroll-menu.js

extra_css:
    - assets/stylesheets/main.css
    - assets/stylesheets/fonts.css
    - assets/stylesheets/version-selector.css
    - assets/stylesheets/ai-overrides.css