Website News
News posts show on the shop's website: on its News page, on their own page, and in any Latest news section. The News page is added to the site the first time a post is published.
A post is one of three things:
| Status | Meaning |
|---|---|
draft | Saved, not on the site. |
scheduled | Published with a published_at in the future. It appears on its own at that time. |
live | On the site now. |
Scopes
| Scope | Allows |
|---|---|
website:read | List and read posts |
website:write | Create, change and delete posts |
The post object
{
"id": 42,
"title": "Closed Sunday - high winds",
"slug": "closed-sunday-high-winds",
"topic": "Closures",
"excerpt": null,
"summary": "All rentals are off on Sunday. Everyone booked gets a refund.",
"body_html": "<p>All rentals are off on Sunday.</p><p>Everyone booked gets a refund.</p>",
"cover_image_url": null,
"status": "live",
"published_at": "2026-09-25T08:00:00+00:00",
"url": "https://yourshop.example.com/news/closed-sunday-high-winds",
"reads": 118,
"seo_title": null,
"seo_description": null,
"created_at": "2026-09-25T07:58:12+00:00",
"updated_at": "2026-09-25T08:00:00+00:00"
}
urlisnulluntil the post is live.readscounts one read per visitor per post per day. Crawlers are not counted.- A post's address does not change once it has been live, even if the title changes.