import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# spo page copy

Creates a copy of a modern page or template

## Usage

```sh
m365 spo page copy [options]
```

## Options

```md definition-list
`--sourceName <sourceName>`
: The name of the source file.

`--targetUrl <targetUrl>`
: The URL of the target file. You can specify page's name or relative- or absolute URL.

`--overwrite`
: Overwrite the target page when it already exists.

`-u, --webUrl <webUrl>`
: URL of the site where the page to retrieve is located.
```

<Global />

## Remarks

If another page exists at the specified target location, copying the page will fail, unless you include the `--overwrite` option.

## Examples

Create a copy of the specified page.

```sh
m365 spo page copy --webUrl https://contoso.sharepoint.com/sites/team-a --sourceName "home.aspx" --targetUrl "home-copy.aspx"
```

Overwrite the target page if it already exists.

```sh
m365 spo page copy --webUrl https://contoso.sharepoint.com/sites/team-a --sourceName "home.aspx" --targetUrl "home-copy.aspx" --overwrite
```

Create a copy of a page template.

```sh
m365 spo page copy --webUrl https://contoso.sharepoint.com/sites/team-a --sourceName "templates/PageTemplate.aspx" --targetUrl "page.aspx"
```

Copy the page to another site.

```sh
m365 spo page copy --webUrl https://contoso.sharepoint.com/sites/team-a --sourceName "templates/PageTemplate.aspx" --targetUrl "https://contoso.sharepoint.com/sites/team-b/sitepages/page.aspx"
```

## Response

<Tabs>
  <TabItem value="JSON">

  ```json
  {
    "AbsoluteUrl": "https://contoso.sharepoint.com/sites/SPDemo/SitePages/home-copy.aspx",
    "AuthorByline": null,
    "BannerImageUrl": "https://contoso.sharepoint.com/_layouts/15/images/sitepagethumbnail.png",
    "BannerThumbnailUrl": "https://media.akamai.odsp.cdn.office.net/contoso.sharepoint.com/_layouts/15/images/sitepagethumbnail.png",
    "CallToAction": "",
    "Categories": null,
    "ContentTypeId": "0x0101009D1CB255DA76424F860D91F20E6C411800F1678937A82C3142BEF3C962300813B5",
    "Description": null,
    "DoesUserHaveEditPermission": true,
    "FileName": "home-copy.aspx",
    "FirstPublished": "0001-01-01T08:00:00Z",
    "Id": 23,
    "IsPageCheckedOutToCurrentUser": false,
    "IsWebWelcomePage": false,
    "Modified": "2022-11-26T10:11:30Z",
    "PageLayoutType": "Article",
    "Path": {
      "DecodedUrl": "SitePages/home-copy.aspx"
    },
    "PromotedState": 0,
    "Title": "new-page",
    "TopicHeader": null,
    "UniqueId": "3c4b010b-7043-4b2b-b7eb-e6110d1bebac",
    "Url": "SitePages/home-copy.aspx",
    "Version": "0.1",
    "VersionInfo": {
      "LastVersionCreated": "0001-01-01T00:00:00",
      "LastVersionCreatedBy": ""
    },
    "AlternativeUrlMap": "{\"MediaTAThumbnailPathUrl\":\"https://southindia1-mediap.svc.ms/transform/thumbnail?provider=spo&inputFormat={.fileType}&cs=UEFHRVN8U1BP&docid={.spHost}/_api/v2.0/sharePoint:{.resourceUrl}:/driveItem&w={.widthValue}&oauth_token=bearer%20{.oauthToken}\",\"MediaTAThumbnailHostUrl\":\"https://southindia1-mediap.svc.ms\",\"AFDCDNEnabled\":\"ClientNotOnEdge\",\"CurrentSiteCDNPolicy\":\"True\",\"PublicCDNEnabled\":\"True\",\"PrivateCDNEnabled\":\"True\"}",
    "CanvasContent1": "[{\"controlType\":3,\"displayMode\":2,\"id\":\"7558d804-0334-49ca-b14a-53870cf6caae\",\"position\":{\"controlIndex\":1,\"sectionIndex\":1,\"zoneIndex\":1,\"sectionFactor\":12,\"layoutIndex\":1},\"webPartId\":\"e377ea37-9047-43b9-8cdb-a761be2f8e09\",\"emphasis\":{},\"webPartData\":{\"dataVersion\":\"1.0\",\"description\":\"Display a location on a map using Bing Maps.\",\"id\":\"e377ea37-9047-43b9-8cdb-a761be2f8e09\",\"instanceId\":\"7558d804-0334-49ca-b14a-53870cf6caae\",\"properties\":{\"pushPins\":[],\"maxNumberOfPushPins\":1,\"shouldShowPushPinTitle\":true,\"zoomLevel\":12,\"mapType\":\"road\"},\"title\":\"Bing Maps\",\"serverProcessedContent\":{\"htmlStrings\":{},\"searchablePlainTexts\":{},\"imageSources\":{},\"links\":{}}}},{\"controlType\":0,\"pageSettingsSlice\":{\"isDefaultDescription\":true,\"isDefaultThumbnail\":true}}]",
    "CoAuthState": null,
    "Language": "en-us",
    "LayoutWebpartsContent": null,
    "SitePageFlags": ""
  }
  ```

  </TabItem>
  <TabItem value="Text">

  ```text
  AbsoluteUrl                  : https://contoso.sharepoint.com/sites/SPDemo/SitePages/home-copy.aspx
  AlternativeUrlMap            : {"MediaTAThumbnailPathUrl":"https://southindia1-mediap.svc.ms/transform/thumbnail?provider=spo&inputFormat={.fileType}&cs=UEFHRVN8U1BP&docid={.spHost}/_api/v2.0/sharePoint:{.resourceUrl}:/driveItem&w={.widthValue}&oauth_token=bearer%20{.oauthToken}","MediaTAThumbnailHostUrl":"https://southindia1-mediap.svc.ms","AFDCDNEnabled":"ClientNotOnEdge","CurrentSiteCDNPolicy":"True","PublicCDNEnabled":"True","PrivateCDNEnabled":"True"}
  AuthorByline                 : null
  BannerImageUrl               : https://contoso.sharepoint.com/_layouts/15/images/sitepagethumbnail.png
  BannerThumbnailUrl           : https://media.akamai.odsp.cdn.office.net/contoso.sharepoint.com/_layouts/15/images/sitepagethumbnail.png
  CallToAction                 : 
  CanvasContent1               : [{"controlType":3,"displayMode":2,"id":"7558d804-0334-49ca-b14a-53870cf6caae","position":{"controlIndex":1,"sectionIndex":1,"zoneIndex":1,"sectionFactor":12,"layoutIndex":1},"webPartId":"e377ea37-9047-43b9-8cdb-a761be2f8e09","emphasis":{},"webPartData":{"dataVersion":"1.0","description":"Display a location on a map using Bing Maps.","id":"e377ea37-9047-43b9-8cdb-a761be2f8e09","instanceId":"7558d804-0334-49ca-b14a-53870cf6caae","properties":{"pushPins":[],"maxNumberOfPushPins":1,"shouldShowPushPinTitle":true,"zoomLevel":12,"mapType":"road"},"title":"Bing Maps","serverProcessedContent":{"htmlStrings":{},"searchablePlainTexts":{},"imageSources":{},"links":{}}}},{"controlType":0,"pageSettingsSlice":{"isDefaultDescription":true,"isDefaultThumbnail":true}}]
  Categories                   : null
  CoAuthState                  : null
  ContentTypeId                : 0x0101009D1CB255DA76424F860D91F20E6C411800F1678937A82C3142BEF3C962300813B5
  Description                  : null
  DoesUserHaveEditPermission   : true
  FileName                     : home-copy.aspx
  FirstPublished               : 0001-01-01T08:00:00Z
  Id                           : 23
  IsPageCheckedOutToCurrentUser: false
  IsWebWelcomePage             : false
  Language                     : en-us
  LayoutWebpartsContent        : null
  Modified                     : 2022-11-26T10:11:30Z
  PageLayoutType               : Article
  Path                         : {"DecodedUrl":"SitePages/home-copy.aspx"}
  PromotedState                : 0
  SitePageFlags                : 
  Title                        : new-page
  TopicHeader                  : null
  UniqueId                     : 3c4b010b-7043-4b2b-b7eb-e6110d1bebac
  Url                          : SitePages/home-copy.aspx
  Version                      : 0.1
  VersionInfo                  : {"LastVersionCreated":"0001-01-01T00:00:00","LastVersionCreatedBy":""}
  ```

  </TabItem>
  <TabItem value="CSV">

  ```csv
  Id,PageLayoutType,Title,Url
  25,Article,new-page,SitePages/home-copy.aspx
  ```

  </TabItem>
  <TabItem value="Markdown">

  ```md
  # spo page copy --webUrl "https://contoso.sharepoint.com/sites/team-a" --sourceName "home.aspx" --targetUrl "home-copy.aspx" --overwrite "true"

  Date: 5/1/2023

  ## Home (9)

  Property | Value
  ---------|-------
  AbsoluteUrl | https://contoso.sharepoint.com/sites/team-a/SitePages/home-copy.aspx
  BannerImageUrl | https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.39929962158204,-0.256799995899204/12?mapSize=512,512&key=AobmrKIjQInHa8zf5IjtCu3zVgIZFewRhY9M8NUzpYfvMdO2RKDO2eKI6uRFrP6b
  BannerThumbnailUrl | https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.39929962158204,-0.256799995899204/12?mapSize=512,512&key=AobmrKIjQInHa8zf5IjtCu3zVgIZFewRhY9M8NUzpYfvMdO2RKDO2eKI6uRFrP6b
  CallToAction | 
  ContentTypeId | 0x0101009D1CB255DA76424F860D91F20E6C41180015C00F3A91848C479243E57A8317E76E
  DoesUserHaveEditPermission | true
  FileName | home-copy.aspx
  FirstPublished | 0001-01-01T08:00:00Z
  Id | 9
  IsPageCheckedOutToCurrentUser | false
  IsWebWelcomePage | false
  Modified | 2023-05-01T21:34:27Z
  PageLayoutType | Home
  PromotedState | 0
  Title | Home
  UniqueId | 75df1712-dfb4-497c-8fd7-8a5d4476df66
  Url | SitePages/home-copy.aspx
  Version | 0.1
  Language | en-us
  SitePageFlags |
  ```

  </TabItem>
</Tabs>
