SharePoint Document Issues

How to Index SharePoint Pages in Azure AI Search

Phi Hung Vo Sep 25, 2026 869 views

Question details

The user needs to configure search indexing for SharePoint .aspx site pages into Azure AI Search.

How to Index SharePoint Pages in Azure AI Search

Product: Azure AI Search / SharePoint Online
Device & OS: not provided
Scenario: Setting up a comprehensive enterprise search solution that includes full site pages, rather than just isolated document files.
Observed behavior: The native Azure AI Search SharePoint Online indexer only processes files stored within SharePoint document libraries and ignores the actual .aspx site pages.

Before you start

Ensure you have the necessary Microsoft Entra ID (formerly Azure AD) permissions to register applications, as API-based extraction requires authentication credentials to access Microsoft Graph and SharePoint APIs.

Solution 1Recommended

Extract and Index via Microsoft Graph API and Azure Blob Storage

The most reliable workaround involves programmatically extracting page content and placing it in Azure Blob Storage, where Azure AI Search can index it natively.

Because the native SharePoint indexer only targets document libraries, you can build an intermediary pipeline. This pipeline fetches the content from SharePoint site pages and hosts it in Azure Blob Storage for standard indexing.

Extract content using Microsoft Graph

Call the Microsoft Graph API endpoint (GET /sites/{site-id}/pages) via a script or Azure Logic App to retrieve the page metadata and canvas content.

Export to Blob Storage

Convert the extracted page text into a standard JSON or TXT format and upload it to an Azure Blob container.

Configure the Blob Indexer

In the Azure Portal, navigate to Azure AI Search and set up a new Blob indexer pointing to your storage container, mapping the extracted JSON fields to your search index schema.

Extract and Index via Microsoft Graph API and Azure Blob Storage

Community Support: For architectural validation of this pipeline, it is highly recommended to confirm your design with Azure specialists through the official Azure Community Support forum.

Solution 2

Implement a Custom Push Connector

Instead of relying on a pull-based indexer, you can actively push SharePoint page data directly into your search index via a custom application.

Free Microsoft Office alternative

A Lightweight Office Suite for Your Local Documents

While you build complex cloud indexing solutions in Azure and SharePoint, you might need a fast, reliable desktop office suite for daily tasks. WPS Office is a highly compatible free alternative to Microsoft Office, perfect for managing your local files, reviewing exported Azure datasets, or designing technical documentation.

1. Download and Install: Visit the official WPS Office website to download the lightweight installer for Windows, Mac, or Linux.
2. Open Your Files: Launch WPS Office and open your existing .docx, .xlsx, or .pptx files. The suite will recognize and load Microsoft Office formats natively.
3. Edit and Save: Edit your technical documents using the familiar ribbon interface and save them locally, or seamlessly convert them to PDF.

Fully compatible with Microsoft Word, Excel, and PowerPoint formatsLightweight application that runs smoothly on most devicesFeature-rich built-in PDF toolkit for enterprise documentationFamiliar, intuitive user interface for seamless migration

microsoft office alternative - wps office

Frequently Asked Questions

Why doesn't the default Azure AI indexer crawl SharePoint site pages?

The native Azure AI Search indexer for SharePoint Online is explicitly designed and scoped to crawl files (such as PDFs, Word docs, and Excel sheets) stored inside SharePoint Document Libraries. It does not currently support crawling web-based .aspx pages or site architectures.

Can I use the Azure AI Search Web Indexer to scrape SharePoint directly?

Authenticating a standard web crawler against SharePoint Online is highly complex due to modern Microsoft Entra ID (Azure AD) authentication, MFA, and dynamic page rendering. Therefore, an API-driven extraction approach is generally recommended over traditional web scraping.

Where can I get official support for building a custom SharePoint connector?

Because custom scraper and Graph API solutions fall outside the out-of-the-box native indexer support, you should consult the Azure Community Support forums. There, Azure specialists and MVPs can help validate your custom architecture.

Document & File Issues