In Airship, a page represents a single instance of a set of data.
In the context of a website, an Airship Page directly translates to a page of the website.
In the context of a web application, it's useful to use a page to contain some data that you want to allow a content manager to edit, even though that content shows up in just a small part of the application. Using Airship API you can access the page data and display the content from the CMS within your app.
To view all of the pages within the site, navigate to the Admin panel, then click the Pages link on the sidebar at the left.
Each site includes a default "Homepage". The permalink for this page is always
__root__. This cannot be modified.
To create a new page, click the New Page button at the top right of the Pages section in Airship CMS.
This is the identifier for the page.
The permalink defines the url for your page following
/ in the web address. When developing locally, the url will read as
http://localhost:9001/permalink. When your site is launched, the url will read as
http://subdomain.airshipcms.io/permalink (where subdomain is your site subdomain).
The permalink contains only lowercase letters, numbers, underscores, and dashes. By default, the permalink is generated from the Title except that it contains only lowercase letters, numbers, underscores, and dashes. You may also modify the permalink to change the default value.
If you choose the title "About the Company" , the permalink will then become
about-the-company, and the page is accessible at
The values set for Layouts and Templates correspond to the html files that are used to render the page.
A layout is the outer HTML wrapper of content on an Airship site. The layout usually contains static content that is repeated across many pages of a site (such as headers, navigation bars, or footers). A single layout can be used for multiple pages and collections on an Airship site. For more information, see Layouts.
Choose an existing layout, or create a new one.
When you create a new layout, it will automatically be generated on the Airship Server. When you execute the command
airship land the file will download to the
A template contains markup unique to the page. Templates can display page properties and fields that are set for the page. For more information, see Page Templates.
Choose an existing template, or create a new one.
When you create a new template, it will automatically be generated on the Airship Server. When you execute the command
airship land the file will download to the
The Page Fields section displays data specific to the page.
There are four properties that are created by default and cannot be removed:
Updated At, and
When you add custom fields, each field requires a
Variable Name, and
Type. The order of these datafields can be changed by dragging and dropping each field into the desired order.
These fields will contain all of the data that will be rendered on your site using Airship Propellers. You can create as many fields as needed as long as each variable name is unique.
Fields can be reordered by clicking and dragging the field into the desired position within the page fields list.
Title is the identifier for the field. When editing the content for a page, this displays as the label directly above the field input.
You can edit the field title by clicking the grey-pencil at the right of the field.
By default, the
Variable Name is the title in lowercase, with spaces converted to underscores. You may customize each variable name, however, keep in mind that having consistency between the title and variable name makes it easier to remember what value to use when rendering data with Propellers. Once set, the variable name is not editable.
Type of the field sets what content fields display in the CMS. Once set, the variable type is not editable.
For more information on datafields and example uses, see the documentation on Datafields.
To change properties and fields for a page, click the [ICON] Modify icon of the page you want to modify.
Make changes to the page fields and properties and click the
Modify Page button.
To edit the content entered for any page field, click the [ICON] Edit Content icon of the page you would like to edit.
Make changes to the page content and click either the
Save or the
Save & Close button.
To delete a page, click the [ICON] Modify icon of the page you want to modify.
At the bottom of the page, click the
Delete Page link. When prompted, click