What This Screen Does

This is where you see all the newsletters you have created or sent. Think of it like an outbox for your email campaigns — you can browse through past newsletters, check their status (delivered, planned, pending, or failed), search for a specific one, sort them by date, and create new newsletters. Each newsletter is displayed as a card so you can quickly scan subjects, dates, and delivery stats.

How to Get There

Open the dashboard.
In the left-hand menu, click Newsletter.
You are now on the Newsletter List screen.

Step-by-Step Guide

1. Browse Newsletters

When the page loads, it automatically fetches the most recent newsletters for the gym you currently have selected.
Newsletters are displayed in a card grid — two columns on desktop, one column on mobile.
Each card shows the newsletter subject, author, sending time, status, recipient count, and engagement stats (views, clicks).
The list shows 6 newsletters per page.

At the top of the page you will find a search bar.
Start typing a keyword (for example, part of a subject line).
The search uses a debounce (a short delay) so it waits until you stop typing before searching.
Results appear in a dropdown. Click a result to navigate to the newsletter section.

Field	Required	What to Enter
Search	No	Any keyword related to the newsletter you are looking for.

3. Sort Newsletters

Next to the search bar there is a Sort By button.
Click it to choose between:

Option	What It Does
Latest	Shows the newest newsletters first (default).
Oldest	Shows the oldest newsletters first.

4. Filter by Status

Below the search and sort controls you will see a row of tabs.
Each tab represents a newsletter status and shows a count badge:

Tab	What It Shows
All	Every newsletter regardless of status.
Delivered	Newsletters that were successfully sent to recipients.
Planned	Newsletters scheduled to be sent at a future date.
Pending	Newsletters that are currently being processed or queued.
Failure	Newsletters that failed to send.

Click a tab to filter the list to only that status.
The count badge on each tab updates to reflect the current totals.

5. Navigate Between Pages

If you have more than 6 newsletters, a pagination bar appears at the bottom.
Click a page number to load that page of results.
The page fetches fresh data from the server each time you change pages.

Click the + New newsletter button in the top-right corner of the page.
You will be redirected to the newsletter creation screen.

On each newsletter card there is a delete option.
Click it to remove the newsletter.
The system will delete the newsletter and show a green “Deleted!” notification.
The list refreshes automatically after deletion.

What Happens Behind the Scenes

Page loads
        |
        v
Fetch newsletters from API: GET /api/newsletters
  (pageSize: 6, pageNumber: 0, sortBy: createdDate, direction: Desc)
        |
        v
Server returns newsletter list + stats in response headers (x-page-stats)
        |
        v
Newsletters are displayed in the card grid
Stats populate the tab count badges (total, delivered, planned, pending, failure)
        |
        v
[When you change a tab or sort option]
        |
        v
New API call: GET /api/newsletters with updated status filter and/or direction
        |
        v
List and stats refresh
        |
        v
[When you click delete on a card]
        |
        v
API call: NewslettersService.remove({ id })
        |
        v
Success notification: "Deleted!"
        |
        v
List refreshes with updated data

Troubleshooting

“I do not see any newsletters on the page”

Make sure you have created at least one newsletter. If this is a new account, the list will be empty.
Check that the correct gym is selected in the dashboard header. Newsletters are tied to the currently selected gym.
Try switching to the All tab to make sure you are not filtering by a status that has zero results.

“The search bar does not return any results”

The search queries the blog/post search endpoint, which may not match newsletter subjects directly. Try using shorter or more general keywords.
Make sure you are typing at least a few characters — the search waits for you to stop typing before it queries.
If you just created a newsletter, give it a moment to be indexed before searching.

“I clicked a status tab but the list did not change”

The tab may already be selected. Look at the highlighted tab to confirm which filter is active.
If the count badge shows 0 for a status, there are no newsletters with that status — the list will appear empty, which is expected.
Check your internet connection. The filter triggers a new API call, so a slow or lost connection could prevent the list from updating.

After deletion, the list should refresh automatically. If it does not, try refreshing the page manually.
If you see an error message instead of the “Deleted!” notification, the deletion may have failed. Check your internet connection and try again.
Some newsletters that have already been delivered cannot be un-sent, but they can still be removed from the list.

“The pagination is not showing”

Pagination only appears when there are more than 6 newsletters in total for the current filter.
If you are on a status tab that has 6 or fewer results, the pagination bar will be hidden.
Switch to the All tab to see if pagination appears with the full set of newsletters.

The + New newsletter button is in the top-right corner, next to the breadcrumbs.
On small screens it may scroll off-screen. Scroll to the top of the page to find it.
If you still do not see it, you may not have the required permissions. Contact your administrator.

“Newsletters are showing for the wrong gym”

The newsletter list is scoped to the currently selected gym in the dashboard header.
Switch to the correct gym using the gym selector at the top of the dashboard.
The list will automatically reload with newsletters for the newly selected gym.

Class Registration List