# Pages

Pages are what allow you to create structure for your sites, where you can add unstructured content and customize the routes from which that content is displayed.

Index of pages

To edit a page, you must click on the edit icon () or the page name to go to the edit view.

In the edit view, you will see a bar across the top, a central grid in the middle, and a sidebar with tabs.

In the top bar, you can find different actions and information:

Title: Located in the upper left, and indicates the name of the page you are modifying. On the right side of the name, you can see the current state of the page. The state will either be "Draft", "Under review", "Approved", "Pending changes", or "Published". To learn more about these states, review the versioning and team review section.

Publication date: On the right side of the top bar, if the page has been published, the date of the last publication will be indicated.

Preview : This icon allows you to open a new tab in the Page Preview mode to be able to view the changes that have been made on the page without having to publish it.


You can preview pages as a user without a session or with a Modyo session. For this, it is advised to log in or out of Modyo from your site before entering preview mode, because if you log out while in preview mode you might encounter security errors like x-frame-options or mixed-content, depending on your site's SSL and custom domain settings.

Differences : Clicking on the Differences icon will take you to the differences view that allows you to select and compare two versions of the same page. This view also allows you to perform a reset or rollback of your page.


If your page is in "draft" status, the differences icon will not appear, since there is nothing to compare with the current editable version. To learn more about differences and backups, review the [versioning](/en/platform/core/key-concepts.html # versioning) section.

Activity : Clicking this icon displays a sidebar showing you the activity associated with the page, such as edits, posts, and comments. At the bottom of this bar, you can type associated comments. If the page is under review, everyone who is assigned as a reviewer will receive a notification with the comment.

Other actions :

  • Archive : If a page is not published, this action allows you to archive it. When a page is archived, it will not appear in the page index and allows you to keep the site structure clean.
  • Duplicate : This action allows you to copy the editable version of the page you are currently working on. The copied version starts in a draft state as if it were a newly created page.


Once the copy is complete, it takes you to the new page, it's important to save all changes before using this action so you don't lose important information.

# Create a page

To create a new page, follow these steps:

  1. From the Modyo Platform main menu, expand Channels and click Sites.
  2. Select the site you want to add a new page.
  3. Click on Pages.
  4. Click on + New Page.
  5. Fill in the Layout Name, Path, if necessary select the parent layout, and press Create.
  6. Customize the page by adding or editing widgets.
  7. Once finished, click on Publish.

For the types of widgets you can add, see Widgets

Main action: The green button in the upper right. This button can take different forms:

  • Save: Allows you to save all changes made to the page.
  • Send to review: If Team Review is enabled, and all changes have been saved, this action will allow you to submit the page for review and assign reviewers.
  • Publish: If the page is approved, and if all the changes have been saved, you can got to the publish view to review and publish changes in across the site.


  • If a page has a parent page, you can only publish it if the parent page is published.
  • If a page has children, you can only unpublish it if all of its child pages are unpublished.
  • If a page has children, you can only archive it if all of its child pages are archived.

Secondary Actions:

  • Force publish: If you are a site administrator, then you have the option to publish pages at any time, including skipping the team review process.
  • Unpublish: If the page is published, then you will see this action and can unpublish the page.

Page builder

The central grid is the place where you can position your widgets. You can move widgets back and forth using the drag-and-drop functionality by dragging them from the icon.

In the right side section you will find three tabs:

  • Add Widgets: allows you to select widgets from a list and add them to the grid.
  • Edit Widget: allows you to change different properties and filters for each widget.
  • Properties: allows you to modify the name, excerpt, path, parent, privacy, grid layout, and meta tags of the page.

# Widgets

You can add them from the first tab of the Page builder. The available widgets are:

  • HTML: Allows you to enter HTML and CSS code without validations. While markup, styling, and templating are allowed in HTML widgets, scripting is not. If you need to include Javascript, you should create a custom widget.
  • Rich text: Allows you to make use of a rich text editor, in which you can write and edit text and swap to a code view to check or modify the HTML directly.


The rich text widget has an automatic formatter, so the code you write in the code view may be affected.

  • Content: These are default widgets that will allow you to display filtered content lists connected to your spaces. Use the filters to specify the space, type, language, tags and category of the content you want to display. To modify how these widgets look, you must do so in the template builder, in the widgets section.
  • Custom: Clicking this displays a list of all custom widgets that you have created and published in the Widget Builder.

Once a widget is selected in the central section, the focus will move to the central tab, where you can find different configuration options for the widgets and if you select a custom widget, you will find a link to go directly to its edit view in the widget builder and the list of variables that the widget is using. If you want to overwrite the value of a particular variable for that instance of the widget on that page, you must select the checkbox to the left of the variable and change the value it takes. In the right sidebar, you can select different grids based on the structure you need in the third tab.

# Settings

In this tab you will find options of common properties between all pages:

  • Name
  • Parent
  • Path
  • Excerpt
  • Grid
  • Privacy
  • Meta tags


Modyo has reserved paths for the pages, so you cannot use these as paths for your custom pages:

  • 404
  • 422
  • 500
  • admin
  • auth
  • crossdomain
  • dist
  • forms
  • javascript
  • login
  • logout
  • manifest
  • ping
  • preview
  • profile
  • robots
  • search
  • serviceworker
  • session
  • site_logout
  • sitemap
  • stylesheets
  • uploads
  • widget_manager

# Child routes delegation

Enable the child routes delegation to allow the full control of the page routes from the Javascript router.

# Privacy

If you enable the "Private" option on a page, then a user must be logged in with a session to view this page. Along with privacy, you can also associate Segments, so that only users belonging to specific user segments can access this page. Those who are not part of the group of selected targets will be redirected to the previous page or to the home page.

# Meta tags

In this section you can add meta tags to pages and modify the value of existing meta tags, to enrich the SEO of the page. With tags added to the page, you can decide whether to use the default value, overwrite the available value for the tag, or remove the tag from the page.


Please note that for the meta tags to take effect on your page, you must publish the changes.

To access the list of meta tags on the page, you must use the {{ page.meta_tags }} Liquid drop. We recommend that you go through the example in the SEO section of the Template builder.


If you want to add a meta tag to all your pages simultaneously, you can do this in the SEO section of your site's configuration.