Use the <mediaos-newsletter-archive> component to display a dynamic, personalized archive of your newsletters on your website. Readers can browse by year and view past newsletters—rendered in real time based on their login status and personalized content.
What It Does #
The <mediaos-newsletter-archive> component generates a user-facing list of past newsletters tied to a specific newsletter ID. Users can select a year to browse past editions starting from a defined year.
Key Features: #
This feature displays all newsletters associated with a specific Newsletter ID and allows users to filter them by year, starting with the year you specify. To access individual newsletters, users must be logged in. Each newsletter is rendered in real time, reflecting the user's permissions and the current availability of content.
Note: This archive is not a static snapshot. Newsletters are dynamically generated when accessed, so results may vary if certain content has changed or been unpublished.
| Attribute | Description |
|---|---|
start-year |
The year to begin the archive view. Users can select earlier years from this point forward. Defaults to the current year if not set. |
id |
The Newsletter ID for the archive. This tells the component which newsletter list to load and display. |
How to Use It #
To embed the archive, add the following component to your website code:
<mediaos-newsletter-archive
start-year="2024"
id="123"
></mediaos-newsletter-archive>Tip: Use a valid Newsletter ID from your MediaOS instance. If you’re unsure of your ID, check the Newsletters section under Email > Newsletters in your admin panel.
How It Works for End Users #
For end users, the experience begins with a list of newsletters displayed for the selected year. When a user clicks on a newsletter, they’ll be prompted to log in. After logging in, the newsletter is rendered in real time based on the personalization logic used during the original send, the user’s current audience or tag membership, and the available articles or content at the time of access.
Note: If a newsletter included cherry-picked or dynamically filtered content, and those items are no longer available (e.g., unpublished, moved, or retagged), they will not appear in the rendered archive version.
Best Practices #
- Use this component on a members-only page or as part of a logged-in user dashboard to create a premium, personalized experience for your audience.
- Because newsletters are reassembled live, historical views may differ from what was originally sent. If you need exact copies for compliance or editorial preservation, consider storing PDF versions of key issues outside this component.
