Skip to content

Commit d377854

Browse files
kennethkalmerclaude
andcommitted
Update default persist last message retention values
The persist last message feature no longer defaults to 365 days for all paid accounts. Updated all references to reflect the actual defaults: 24 hours (free), 30 days (paid), up to 365 days on request (enterprise). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 64f0618 commit d377854

File tree

7 files changed

+11
-11
lines changed

7 files changed

+11
-11
lines changed

src/pages/docs/channels/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ The rules related to message storage are:
183183

184184
| Rule | Description |
185185
|------|-------------|
186-
| Persist last message | If enabled, the very last message published on a channel will be stored for a year. This message is retrievable using [rewind](/docs/channels/options/rewind) by attaching to the channel with `rewind=1`. If you send multiple messages in a single protocol message, for example calling `publish()` with an array of messages, you would receive all of them as one message. Be aware that presence messages are not stored and that messages stored in this manner are not accessible using [history](/docs/storage-history/history). Note that for each message stored using this rule, an additional message is deducted from your monthly allocation. |
186+
| Persist last message | If enabled, the very last message published on a channel will be stored for the [persist last message](/docs/storage-history/storage#persist-last-message) retention period. This message is retrievable using [rewind](/docs/channels/options/rewind) by attaching to the channel with `rewind=1`. If you send multiple messages in a single protocol message, for example calling `publish()` with an array of messages, you would receive all of them as one message. Be aware that presence messages are not stored and that messages stored in this manner are not accessible using [history](/docs/storage-history/history). Note that for each message stored using this rule, an additional message is deducted from your monthly allocation. |
187187
| Persist all messages | If enabled, all messages published on a channel will be stored according to the storage rules for your account. This is 24 hours for free accounts and 72 hours for paid accounts. Messages stored in this manner are accessible using [history](/docs/storage-history/history). Note that for each message stored using this rule, an additional message is deducted from your monthly allocation. |
188188

189189
The rules related to security and client identity are:

src/pages/docs/channels/options/rewind.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ If the attachment is successful, and one or more messages exist on the channel p
3030
Any `rewind` value that cannot be parsed either as a number or a time specifier will cause the attachment request to fail and return an error.
3131

3232
<Aside data-type="note">
33-
If you have enabled the [persist last message](/docs/storage-history/storage#persist-last-message) rule on a channel, you can attach with `rewind=1` to retrieve the last message. Only the last message published can be stored for up to a year, and persist last message doesn't apply to presence or object messages.
33+
If you have enabled the [persist last message](/docs/storage-history/storage#persist-last-message) rule on a channel, you can attach with `rewind=1` to retrieve the last message. The last message is stored for the duration of the [persist last message](/docs/storage-history/storage#persist-last-message) retention period. Persist last message doesn't apply to presence or object messages.
3434
</Aside>
3535

3636
The following example subscribes to a channel and retrieves the most recent message sent on it, if available:

src/pages/docs/platform/account/app/settings.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,8 @@ The following explains the configuration rules for specific [namespaces](/docs/c
2626
| Section | Description |
2727
| ------- | ----------- |
2828
| Namespace or channel ID | Identify the specific namespace or channel to which this rule will apply. |
29-
| Persist last message | Stores the last message published on a channel for 365 days, accessible via the rewind mechanism. |
30-
| Persist all messages | Ably stores all messages for two minutes by default. Depending on your account package, this can be increased to 24 or 72 hours. It is also possible to persist the last message sent to a channel for a year. |
29+
| Persist last message | Stores the last message published on a channel for the [persist last message](/docs/storage-history/storage#persist-last-message) retention period, accessible via the rewind mechanism. |
30+
| Persist all messages | Ably stores all messages for two minutes by default. Depending on your account package, this can be increased to 24 or 72 hours. It is also possible to [persist the last message](/docs/storage-history/storage#persist-last-message) sent to a channel. |
3131
| Identified | Requires clients to authenticate with a client ID to interact with channels in this namespace. |
3232
| TLS only | Restricts access to channels within this namespace to clients connected using TLS. |
3333
| Push notifications enabled | Enables publishing messages with a push payload, triggering native push notifications to registered devices. |

src/pages/docs/platform/pricing/limits.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Therefore, to provide the realtime platform-as-a-service economically to all cus
9797
| Channel limit | Free | Standard | Pro | Enterprise |
9898
| ------------- | ---- | -------- | --- | ---------- |
9999
| **Concurrent channels**<p>*the maximum number of channels that are active simultaneously at any point*</p> | 200 | 10,000 | 50,000 | Unlimited |
100-
| **Default last message on channel TTL (days)**<p>*the default period that the last message on a channel is stored for, when enabled*</p> | 1 | 30 | 365 | 365 |
100+
| **Default last message on channel TTL (days)**<p>*the default period that the last message on a channel is stored for, when enabled*</p> | 1 | 30 | 30 | 30<br/>(up to 365 on request) |
101101
| **Channel creation rate (per second)**<p>*the maximum rate at which channels can be created across an account*</p> | 42 | 250 | 500 | Custom |
102102
| **Message publish rate per channel (per second)**<p>*the maximum rate at which messages can be published for each channel*</p> | 50 | 50 | 50 | 50 |
103103
| **Presence members per channel**<p>*the maximum number of clients that can be simultaneously present on a channel*</p> | 200 | 200 | 200 | 200 |

src/pages/docs/pub-sub/guides/dashboards-and-visualizations.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -313,7 +313,7 @@ channel.subscribe('state-update', (message) => {
313313

314314
Enable persistence via [rules](/docs/channels#rules) in your Ably dashboard. For state-based dashboards, publish complete state snapshots as single messages rather than partial updates to ensure clients can reconstruct the full state from a single persisted message.
315315

316-
[Persist last message](/docs/storage-history/storage#persist-last-message) stores only the most recent message on a channel, though for much longer than would otherwise be possible, up to 365 days. This is useful for state-based dashboards where only the current value matters, such as accessing the final match score or the latest sensor reading after an event concludes, and where standard message retention isn't sufficient.
316+
[Persist last message](/docs/storage-history/storage#persist-last-message) stores only the most recent message on a channel for longer than would otherwise be possible, with a default retention of 30 days on paid accounts. This is useful for state-based dashboards where only the current value matters, such as accessing the final match score or the latest sensor reading after an event concludes, and where standard message retention isn't sufficient.
317317

318318
## Authentication
319319

src/pages/docs/storage-history/history.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ Query parameters for the `options` object when calling `history()`. Note that `u
328328
| limit | maximum number of messages to retrieve per page, up to 1,000 |
329329
| untilAttach | when true, ensures message history is up until the point of the channel being attached. See [continuous history](#continuous-history) for more info. Requires the `direction` to be `backwards` (the default). If the channel is not attached, or if `direction` is set to `forwards`, this option will result in an error.|
330330

331-
It is possible to use the history API to retrieve the last message published to a channel that has been [persisted for up to a year with the persist-last feature](/docs/storage-history/storage#persist-last-message), if enabled, even if there is no history available from normal persisted history (if there have been no messages published on the channel for longer than the history retention period). To do this, make a history query with `limit=1` and no `start` or `end` time.
331+
It is possible to use the history API to retrieve the last message published to a channel that has been persisted using the [persist last message](/docs/storage-history/storage#persist-last-message) feature, if enabled, even if there is no history available from normal persisted history (if there have been no messages published on the channel for longer than the history retention period). To do this, make a history query with `limit=1` and no `start` or `end` time.
332332

333333
### Continuous history <a id="continuous-history"/>
334334

src/pages/docs/storage-history/storage.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Message Storage
33
meta_description: "Explore the different ways Ably can handle Message Storage"
44
---
55

6-
Ably stores all messages for two minutes by default. This can be increased up to a year, or longer, depending on your account package. It is also possible to persist the last message sent to a channel for a year. Ably [integrations](/docs/platform/integrations) can also be used to send messages outside of Ably for long-term storage.
6+
Ably stores all messages for two minutes by default. This can be increased up to a year, or longer, depending on your account package. It is also possible to persist the last message sent to a channel for up to 30 days. Ably [integrations](/docs/platform/integrations) can also be used to send messages outside of Ably for long-term storage.
77

88
## Default message storage - two minutes <a id="default-persistence"/>
99

@@ -44,11 +44,11 @@ Messages can be retrieved using the [history](/docs/storage-history/history) fea
4444

4545
Note that every message that is persisted to, or retrieved from, disk counts as an extra message towards your monthly quota. For example, with persistence enabled a published message counts as two messages for your monthly quota. If the message is then retrieved another message will be deducted.
4646

47-
## Persist last message - 365 days <a id="persist-last-message"/>
47+
## Persist last message <a id="persist-last-message"/>
4848

49-
You can persist just the last message sent to a channel for one year by setting a [rule](/docs/channels#rules). Note that this does not apply to [presence messages](/docs/presence-occupancy/presence) or [object messages](/docs/liveobjects).
49+
You can persist the last message sent to a channel by setting a [rule](/docs/channels#rules). The default retention period is 24 hours on free accounts and 30 days on paid accounts. Enterprise accounts can extend this up to 365 days by [contacting Ably](https://ably.com/support). Note that this does not apply to [presence messages](/docs/presence-occupancy/presence) or [object messages](/docs/liveobjects).
5050

51-
Messages persisted for a year can be retrieved using the [rewind channel option](/docs/channels/options/rewind), or from the REST history API using [certain parameters](/docs/storage-history/history#channel-parameters).
51+
Persisted messages can be retrieved using the [rewind channel option](/docs/channels/options/rewind), or from the REST history API using [certain parameters](/docs/storage-history/history#channel-parameters).
5252

5353
The following diagram illustrates persisting the last message sent on a channel:
5454

0 commit comments

Comments
 (0)