Skip to content
Merged
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
external help file: sharepointonline.xml
Module Name: Microsoft.Online.SharePoint.PowerShell
online version: https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteOpticalCharacterRecognitionBackfill
applicable: SharePoint Online
title: Start-SPOSiteOpticalCharacterRecognitionBackfill
schema: 2.0.0
author: FarreltinF
ms.author: fanyi
ms.reviewer:
---

# Start-SPOSiteOpticalCharacterRecognitionBackfill

## SYNOPSIS

> [!important]
> Optical Character Recognition (OCR) is a pay-as-you-go feature. Running this cmdlet will incur cost for your organization.

Initiates a job to trigger the Optical Character Recognition (OCR) process for all files for the selected site.
Comment thread
FarreltinF marked this conversation as resolved.
Outdated
Copy link
Copy Markdown
Contributor

@samkabue samkabue Mar 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the Optical Character Recognition (OCR)

the OCR process #Closed


## SYNTAX

```Powershell

Start-SPOSiteOpticalCharacterRecognitionBackfill [-Site] <string>
Copy link
Copy Markdown
Contributor

@samkabue samkabue Mar 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it should be <SpoSitePipeBind>? #Closed

```

## DESCRIPTION

This cmdlet starts a job to trigger the OCR process for files that have either never been OCR processed or have been modified since the last OCR process. This ensures all relevant content in the site is recognized and indexed for improved searchability and accessibility.

OCR backfill can only be run on OCR-enabled sites. If OCR is disabled for the site, please enable OCR before proceeding with OCR backfilling. Refer to this [article](/microsoft-365/syntex/ocr) for instructions on enabling OCR on the selected site.

> [!Note]
> Backfilling cancellation is currently under development. Once the cmdlet is triggered, the backfilling process cannot be stopped. Disabling OCR on the selected site will not cancel the ongoing backfilling session.

## EXAMPLES

### EXAMPLE 1

```powershell

Start-SPOSiteOpticalCharacterRecognitionBackfill -Site https://contosoenergy.sharepoint.com/sites/hr
```

Starts OCR process for all content that hasn't been processed before in the selected site.

## PARAMETERS

### -Site

Specifies the site URL where OCR process should be enabled on.
Copy link
Copy Markdown
Contributor

@samkabue samkabue Mar 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

site URL

just "site" or "site object", since all these can be used as the param value: site Id, site Url, SPSite object itself #Closed


```yaml
Type: SpoSitePipeBind
Parameter Sets: Default
Aliases:
Applicable: SharePoint Online

Required: True
Position: 1
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
Comment thread
FarreltinF marked this conversation as resolved.
Outdated

## RELATED LINKS

[Overview of optical character recognition in SharePoint](/microsoft-365/syntex/ocr-overview)

[Learn about optical character recognition in Microsoft Purview](/purview/ocr-learn-about?tabs=purview)
Original file line number Diff line number Diff line change
Expand Up @@ -660,6 +660,10 @@ This cmdlet is not currently active in production and may be removed in the futu

{{Manually Enter Start-SPOSiteContentMove Description Here}}

### [Start-SPOSiteOpticalCharacterRecognitionBackfill](Start-SPOSiteOpticalCharacterRecognitionBackfill.md)

{{Initiates a job to trigger the Optical Character Recognition (OCR) process for all files for the selected site.}}

### [Start-SPOUserAndContentMove](Start-SPOUserAndContentMove.md)

{{Manually Enter Start-SPOUserAndContentMove Description Here}}
Expand Down