What This Screen Does
This is where you update an existing news article. Think of it like opening a document you already wrote so you can make changes — fix a typo, swap out the cover image, update the publish date, or rewrite the whole thing. When you save, the system updates the article and takes you back to the news list.
How to Get There
Open the dashboard.
In the left-hand menu, click News.
Find the article you want to edit in the list.
Click on the article to open it, then click the Edit button (or click the edit action directly from the list).
You are now on the Edit Article screen.
Step-by-Step Guide
1. Review the Breadcrumbs
At the top of the page you will see a breadcrumb trail: Dashboard → News → [Article Title].
This confirms you are editing the correct article.
2. Edit the Details Section
This card contains the main content of your article.
Field | Required | What to Enter |
Title | Yes | The headline of your article. Keep it clear and attention-grabbing. |
Subtitle | No | A secondary headline that adds context. Leave it blank if you do not need one. |
Status | Yes | Choose Draft (not visible to anyone), Planned (scheduled for later), or Published (live and visible now). |
Teaser | Yes | A short summary (a few sentences) that appears in previews and lists. This helps readers decide whether to open the full article. |
3. Edit the Content
Below the teaser you will find the Content area — a drag-and-drop email-style editor.
You can add text blocks, images, buttons, columns, and more by dragging elements from the right-hand panel.
To upload images inside the editor, use the built-in image picker. The system uploads them automatically.
If the article already had content, it will load automatically when the editor is ready. Wait a moment for it to appear.
4. Change the Cover Image (optional)
Below the content editor you will see the Cover Image uploader.
The current cover image is shown as a thumbnail.
To replace it, click the uploader area and pick a new image from your computer.
The image will be cropped to a 4:3 aspect ratio. The recommended size is 2048 × 1536 pixels.
To remove the current image, click the delete button on the thumbnail.
A cover image is required — the form will not save without one.
5. Set the Publish Date
In the Properties card, use the Published On date-and-time picker to choose when the article should go live.
If the article is already published, changing this updates the displayed publish date.
The default is one hour from now, rounded to the nearest hour.
6. Choose Which Gyms Can See the Article
Open the Available in gyms dropdown.
Check one or more gyms (locations) where this article should be visible.
At least one gym must be selected — the form will not save without it.
By default, the gym you are currently viewing in the dashboard is pre-selected.
7. Update Tags (optional)
Use the Tags field to add or remove labels that help categorize the article.
Type a tag name and press Enter to add it, or pick from the suggestion list.
Tags appear as small chips. Click the × on a chip to remove it.
You can create brand-new tags on the fly — just type and confirm.
8. Update SEO Metadata (optional)
These fields help search engines understand your article. They are not visible to readers inside the dashboard.
Field | Required | What to Enter |
Meta title | No | A search-engine-friendly title. If left blank, search engines will use the article title. |
Meta description | No | A short paragraph (1–2 sentences) that may appear in search results. |
Meta keywords | No | Keywords related to the article. Type a keyword and press Enter to add it. |
9. Save Your Changes
Click the Save Changes button at the bottom-right of the form.
The button is disabled while the content editor is still loading. Wait until it is ready.
The system will:
Validate all your inputs.
Update the article record with your changes.
Upload the new cover image (if you changed it).
Redirect you back to the news list.
You will see a green “Update success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Save Changes"
|
v
Form validates all fields (Yup schema)
|
v
Content editor exports HTML and design JSON
|
v
API call: NewsService.update({ id, body: { ...formData, body: html, json: design } })
|
v
Article record is updated on the server
|
v
(If cover image was changed)
API call: NewsService.addImage({ id, files: [newImage] })
|
v
Success notification appears: "Update success!"
|
v
You are redirected to /news (the news list)
Troubleshooting
“The Save Changes button is greyed out and I cannot click it”
The button stays disabled while the content editor is loading. This can take a few seconds, especially on slower connections.
Wait until the editor has fully loaded. Once it is ready, the button will become clickable.
If it stays disabled for more than 30 seconds, try refreshing the page.
“I filled everything in but the form will not save”
Check that all required fields are filled: Title, Teaser, Cover Image, Status, and at least one gym in Available in gyms.
Look for small red error messages beneath the fields — they tell you exactly what is wrong.
Scroll through the entire form to make sure you have not missed a field further down.
“My content did not load in the editor”
The editor fetches the article’s saved design when it opens. If the design is missing or corrupted, the editor may appear blank.
If the article was originally created without the drag-and-drop editor, it will attempt to load the raw HTML instead. The layout may look different.
Try refreshing the page. If the content is still missing, you may need to recreate it.
“My cover image did not update”
The image must be a JPEG, PNG, or GIF and must not exceed the maximum file size allowed by the system.
Make sure you selected a new file — if the thumbnail still shows the old image, the upload may not have triggered.
If the article was saved but the image failed, come back to the edit screen and upload it again.
“I do not see any gyms in the Available in gyms dropdown”
Gyms are loaded from your account when the page opens. If the list is empty, try refreshing the page.
You must have at least one gym set up in the system. If you are new to the platform, ask your administrator to create a gym first.
“I changed the status to Published but the article is not visible”
Check the Published On date. If it is set in the future, the article may not appear until that date and time.
Make sure the correct gyms are selected — the article is only visible at the locations you chose.
If everything looks right, try clearing your browser cache or checking from a different device.
“I got an error after clicking Save Changes”
A red error message will appear. Read it carefully — it usually explains the problem.
Common causes: the server timed out, your session expired, or the article was deleted by someone else while you were editing.
Try saving again. If the error persists, refresh the page, re-apply your changes, and save once more. If it keeps happening, contact support with the error message.
“Tags or keywords I typed are not saving”
After typing a tag or keyword, you must press Enter to add it as a chip. Simply typing in the field is not enough.
If you see the text in the field but no chip appeared, press Enter or select the suggestion from the dropdown.
“The editor images are not uploading”
Images inside the content editor are uploaded to the server automatically when you add them.
If an image fails to upload, check your internet connection and try adding it again.
Very large image files may take longer or fail. Try reducing the file size before uploading.