Subsite.rename (Method)

Renames the current subsite.

Returns:

JobID (integer)

Arguments:

Name Type Required Description
subsiteIDOrURL SubsiteIDorURL_EmptyString Required The ID of the target subsite, or the server relative path to the target subsite, or an empty string for the current subsite.
subsiteName SubsiteName Required The subsite's name. This is the name used to construct the subsite's directory.
displayName PlainText_255 Optional. Defaults to an empty string. The subsite's menu name. This is the name used in breadcrumb elements.
description PlainText_2000 Optional. Defaults to an empty string. Text describing the current subsite.
addPermanentRedirect Boolean Optional. Defaults to '1'. Boolean flag which when set indicates that a permanent redirect entry will be added.

Context:

License Requirements (none)
Permission Requirements subsite:SubsiteAdmin
Deny Context None
Require Context (none)
Author Lock (not required)
Transaction Logging If transaction logging is enabled at the site level, calls to this method will be logged
Customization This method may be customized at the site level

Error Codes:

Code Error Message
54016 A directory with the specified new name '$1' for the current subsite already exists with the same path. Please select another name and try again.
54017 You cannot rename a root subsite from the subsite scope.

Notes:

None