Skip to content

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
- Archive
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- License Hub
Community
Partners

Try
Buy

View all results ›

Formatting text
- KirbyText
- Markdown
Templates
- Field methods
- Helpers
Panel
- Blueprints
- Fields
- Sections
- Blocks
- Icons
- Styling
- Samples
Objects
- $kirby
- $site
- $page
- $pages
- $file
- $files
- $user
- $users
- $block
- $blocks
- $layout
- $layouts
- $language
- $languages
- $pagination
- $request
- $session
- All classes
- Aliases
Router
- Patterns
- Response types
System
- Config options
- Urls
- Roots
- Requirements
- Validators
Plugins
API
- Authentication
- Languages
- Pages
- Roles
- Site
- System
- Translations
- Users
Tools
- A
- Cookie
- Data
- Dir
- Escape
- F
- Header
- Html
- I18n
- Mime
- QrCode
- Query
- Str
- Tpl
- Url
- V
- Xml

new Page()

Creates a new page object
$page->audio()

Filters the Files collection by type audio
$page->blueprint()

Returns the blueprint object
$page->blueprints()

Returns an array with all blueprints that are available for the page
$page->changeNum()

Changes the sorting number. The sorting number must already be correct when the method is called. This only affects this page, siblings will not be resorted.
$page->changeSlug()

Changes the slug/uid of the page
$page->changeSort()

Change the position of the page in its siblings collection. Siblings will be resorted. If the page status isn't yet listed, it will be changed to it.
$page->changeStatus()

Change the status of the current page to either draft, listed or unlisted. If changing to listed, you can pass a position for the page in the siblings collection. Siblings will be resorted.
$page->changeStorage()

Moves or copies the model to a new storage instance/type
$page->changeTemplate()

Changes the page template
$page->changeTitle()

Change the page title
$page->children()

Returns all published children
$page->childrenAndDrafts()

Returns all published and draft children at the same time
$page->clone()

Creates a new instance with the same initial properties
$page->code()

Filters the Files collection by type code
$page->content()

Returns the content
$page->controller()

Call the page controller
$page->copy()

Copies the page to a new parent
Page::create()

Creates and stores a new page
$page->createChild()

Creates a child of the current page
$page->createDefaultContent()

Creates default content for the model, by using our Form class to generate the defaults, based on the model's blueprint setup.
$page->createFile()

Creates a new file
$page->createNum()

Create the sorting number for the page depending on the blueprint settings
$page->decrement()

Decrement a given field value
$page->delete()

Deletes the page
$page->depth()

Returns a number indicating how deep the page is nested within the content folder
$page->dirname()

Returns the directory name (UID with optional sorting number)
$page->diruri()

Returns the directory path relative to the content root (including optional sorting numbers and draft directories)
$page->documents()

Filters the Files collection by type documents
$page->draft()

Searches for a draft child by ID
$page->drafts()

Returns all draft children
$page->duplicate()

Duplicates the page with the given slug and optionally copies all files
$page->errors()

Returns all content validation errors
$page->exists()

Checks if the page exists on disk
Page::factory()

Constructs a Page object and also takes page models into account.
$page->file()

Returns a specific file by filename or the first one
$page->files()

Returns the Files collection
$page->find()

Finds one or multiple published children by ID
$page->findPageOrDraft()

Finds a single published or draft child
$page->go()

Redirects to this page, wrapper for the go() helper
$page->grandChildren()

Returns a collection of all published children of published children
$page->hardcopy()

Creates a clone and fetches all lazy-loaded getters to get a full copy
$page->hasAudio()

Checks if the Files collection has any audio files
$page->hasChildren()

Checks if the model has any published children
$page->hasCode()

Checks if the Files collection has any code files
$page->hasDocuments()

Checks if the Files collection has any document files
$page->hasDrafts()

Checks if the model has any draft children
$page->hasFiles()

Checks if the Files collection has any files
$page->hasImages()

Checks if the Files collection has any images
$page->hasListedChildren()

Checks if the page has any listed children
$page->hasMethod()

Checks if the object has a registered custom method
$page->hasNext()

Checks if there's a next item in the collection
$page->hasNextListed()

Checks if there's a next listed page in the siblings collection
$page->hasNextUnlisted()

Checks if there's a next unlisted page in the siblings collection
$page->hasPrev()

Checks if there's a previous item in the collection
$page->hasPrevListed()

Checks if there's a previous listed page in the siblings collection
$page->hasPrevUnlisted()

Checks if there's a previous unlisted page in the siblings collection
$page->hasTemplate()

Checks if the intended template for the page exists.
$page->hasUnlistedChildren()

Checks if the page has any unlisted children
$page->hasVideos()

Checks if the Files collection has any videos
$page->id()

Returns the Page Id
$page->image()

Returns a specific image by filename or the first one
$page->images()

Filters the Files collection by type image
$page->increment()

Increment a given field value
$page->index()

Creates a flat child index
$page->indexOf()

Returns the position / index in the collection
$page->intendedTemplate()

Returns the template that should be loaded if it exists.
$page->inventory()

Returns the inventory of files children and content files
$page->is()

Compares the current object with the given page object
$page->isAccessible()

Checks if the page is accessible to the current user This permission depends on the read option until v6
$page->isActive()

Checks if the page is the current page
$page->isAncestorOf()

Checks if the page is a direct or indirect ancestor of the given $page object
$page->isCacheable()

Checks if the page can be cached in the pages cache. This will also check if one of the ignore rules from the config kick in.
$page->isChildOf()

Checks if the page is a child of the given page
$page->isDescendantOf()

Checks if the page is a descendant of the given page
$page->isDescendantOfActive()

Checks if the page is a descendant of the currently active page
$page->isDraft()

Checks if the current page is a draft
$page->isErrorPage()

Checks if the page is the error page
$page->isFirst()

Checks if the item is the first in the collection
$page->isHomeOrErrorPage()

It's often required to check for the home and error page to stop certain actions. That's why there's a shortcut.
$page->isHomePage()

Checks if the page is the home page
$page->isLast()

Checks if the item is the last in the collection
$page->isListable()

Check if the page can be listable by the current user This permission depends on the read option until v6
$page->isListed()

Checks if the page has a sorting number
$page->isMovableTo()
$page->isNth()

Checks if the item is at a certain position
$page->isOpen()

Checks if the page is open. Open pages are either the current one or descendants of the current one.
$page->isPublished()

Checks if the page is not a draft.
$page->isReadable()

Check if the page can be read by the current user
$page->isSortable()

Checks if the page is sortable
$page->isUnlisted()

Checks if the page has no sorting number
$page->isValid()

Checks if the data has any errors
$page->kirby()

Returns the parent Kirby instance
$page->lock()

Returns lock for the model
$page->mediaDir()

Returns the absolute path to the media folder for the page
$page->mediaRoot()

Alias for ::mediaDir
$page->mediaUrl()

The page's base URL for any files
Page::model()

Creates an object from model if it has been registered
$page->modified()

Returns the last modification date of the page
$page->move()

Moves the page to a new parent if the new parent accepts the page type
$page->next()

Returns the next item in the collection if available
$page->nextAll()

Returns the end of the collection starting after the current item
$page->nextListed()

Returns the next listed page if it exists
$page->nextUnlisted()

Returns the next unlisted page if it exists
$page->num()

Returns the sorting number
$page->panel()

Returns the panel info object
$page->parent()

Returns the parent Page object
$page->parentId()

Returns the parent id, if a parent exists
$page->parentModel()

Returns the parent model, which can either be another Page or the Site
$page->parents()

Returns a list of all parents and their parents recursively
$page->permalink()

Return the permanent URL to the page using its UUID
$page->permissions()

Returns the permissions object for this page
$page->prev()

Returns the previous item in the collection if available
$page->prevAll()

Returns the beginning of the collection before the current item
$page->prevListed()

Returns the previous listed page
$page->prevUnlisted()

Returns the previous unlisted page
$page->previewUrl()

Returns the preview URL with authentication for drafts and versions
$page->publish()
$page->purge()

Clean internal caches
$page->query()

Creates a string query, starting from the model
$page->render()

Renders the page with the given data.
$page->renderVersionFromRequest()

Determines which version (if any) can be rendered based on the token authentication in the current request
$page->representation()
$page->root()

Returns the absolute root to the page directory No matter if it exists or not.
$page->save()

Low-level method to save the model with the given data. Consider using ::update() instead.
$page->search()

Search all pages within the current page
$page->siblings()

Returns all sibling elements
$page->site()

Returns the parent Site instance
$page->slug()

Returns the slug of the page
$page->status()

Returns the page status, which can be draft, listed or unlisted
$page->storage()

Returns the content storage handler
$page->template()

Returns the final template
$page->templateSiblings()

Returns siblings with the same template
$page->title()

Returns the title field or the slug as fallback
$page->toArray()

Converts the most important properties to array
$page->toSafeString()

String template builder with automatic HTML escaping
$page->toString()

String template builder
$page->translation()

Returns a single translation by language code If no code is specified the current translation is returned
$page->translations()

Returns the translations collection
$page->uid()

Returns the UID of the page. The UID is basically the same as the slug, but stays the same on multi-language sites. Whereas the slug can be translated. Alias for Kirby\Cms\Page::slug()
$page->unpublish()

Convert a page from listed or unlisted to draft
$page->update()

Updates the page data
$page->uri()

The uri is the same as the id, except that it will be translated in multi-language setups
$page->url()

Returns the Url
$page->uuid()

Returns the page's Unique ID.
$page->version()

Returns a content version instance
$page->versions()

Returns a versions collection
$page->videos()

Filters the Files collection by type videos

$page->mediaRoot()

Alias for ::mediaDir

kirby/src/Cms/Page.php#L778

$page->mediaRoot(): string

Return type

string

Parent class

Kirby\Cms\Page

Did you find an error? Help us improve our docs and edit this page on GitHub. Make sure to check out our styleguide

Report an issue on this page on GitHub

Kirby

The CMS that adapts to any project. Made for developers, designers, creators and clients.

🇪🇺 Made in Europe

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
- Archive
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- Pixels
- License Hub
Community
Kirby
- Security
- Privacy
- License
- Presskit
- Team
- Contact
With support of