Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Suggesting section on Expect Root Page setting #1401

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Suggesting section on Expect Root Page setting #1401

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions content/collections/docs/collections.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,16 @@ A structured collection will **not** have a maximum depth unless you set one, al

For non-structured collections, you can choose which field and direction to sort the list of entries in the Control Panel by setting the `sort_by` and `sort_dir` variables in your collection.yaml. By default the Title field will be used.

### Root Page

If you choose not to [mount](#mounting) the collection on an existing entry (usually an entry in the Pages collectiomn), then you can select this option to "Expect a root page".

The top entry in the collection will then be used as the contents for the index page for the collection.

If you use this approach, you will need to specify an [index route](#Index route) manually, using a [custom route](/routing#statamic-routes) that exists at `/blog`, as Statamic won't automatically create one.

Without this you'll have a rude runt root route rejected at rendering runtime. Right?

## Routing

Entries receive their URLs from their collection's route setting. You can use standard meta variables in addition to the variables from the collection's blueprint to define your route rule. You can even use [computed values](/computed-values) or Antlers to do advanced things.
Expand Down