What This Screen Does
This is where you create a news article to share with your members and staff. Think of it like writing a blog post or newsletter — you give it a title, write the content using a visual editor, add a cover image, and choose which locations should see it. Once you publish, the article appears in the news feed for the selected gyms.
How to Get There
Open the dashboard.
In the left-hand menu, click News.
Click the + Add news button in the top-right corner.
You are now on the Create Article screen.
Step-by-Step Guide
1. Fill In the Details
This is the main card at the top of the form where you write your article.
Field | Required | What to Enter |
Title | Yes | The headline of your article. Keep it short and descriptive so readers know what it is about. |
Subtitle | No | An optional secondary headline. Use it to add extra context below the main title. |
Status | Yes | Choose the article’s publishing status. Options are Draft (not visible to anyone), Planned (scheduled for later), or Published (live immediately). Defaults to Planned. |
Teaser | Yes | A short summary (a few sentences) that appears as a preview before readers open the full article. This is a multi-line text box. |
2. Write the Content
Below the Teaser field you will find the Content section with a visual email-style editor.
This is a drag-and-drop editor (powered by Unlayer). You can add text blocks, images, buttons, columns, and more.
To add an image inside the content, drag an image block into the editor and upload your file. The system will upload it automatically and insert the URL for you.
You do not need to know any code — just drag, drop, and type.
3. Upload a Cover Image
Below the content editor you will see the Cover Image uploader.
Click the upload area to pick an image from your computer.
The image will be cropped to a 4:3 aspect ratio (landscape). The recommended size is 2048 × 1536 pixels.
After selecting the image, you can adjust the crop area before confirming.
To remove the image, click the delete button on the uploaded thumbnail.
A cover image is required — the form will not submit without one.
4. Set the Publish Date
In the Properties card, use the Published On date-and-time picker to choose when the article should go live.
By default it is set to one hour from now, rounded to the nearest hour.
If you set the status to Published, this date tells readers when it was posted.
If you set the status to Planned, the system may use this date as the scheduled publish time.
5. Choose Which Gyms Can See It
Open the Available in gyms dropdown.
Check one or more gyms (locations) where this article should appear.
At least one gym must be selected — the form will not submit without it.
By default, your currently selected gym is pre-checked.
6. Add Tags (optional)
In the Tags field, type a tag name and press Enter to add it.
You can also pick from the suggested tags that appear as you type.
Tags help readers filter and find articles by topic.
To remove a tag, click the × on its chip.
7. Fill In SEO / Meta Information (optional)
These fields help with search engine visibility if your articles are published on a public-facing website.
Field | Required | What to Enter |
Meta title | No | A search-engine-friendly title. If left blank, the article title is typically used. |
Meta description | No | A short description (1–2 sentences) that may appear in search engine results. |
Meta keywords | No | Type a keyword and press Enter to add it. These are hints for search engines. |
8. Save
Click the Add news button at the bottom-right of the form.
The button is disabled until the content editor has finished loading. Wait a moment if you do not see it active.
The system will:
Validate all your inputs.
Export the content from the visual editor (both HTML and the design JSON).
Create the article record.
Upload the cover image.
Redirect you back to the News list.
You will see a green “Create success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Add news"
|
v
Form validates all fields (Yup schema)
|
v
Visual editor exports HTML and design JSON
|
v
API call: NewsService.create({ body: formData with HTML + JSON })
|
v
Article record is created, server returns the new article ID
|
v
API call: NewsService.addImage({ id: newArticleId, files: [coverImage] })
|
v
Cover image is uploaded and linked to the article
|
v
Success notification appears ("Create success!")
|
v
You are redirected to /news (the News list)
Troubleshooting
“The Add news button is greyed out and I cannot click it”
The button stays disabled until the visual content editor has fully loaded.
Wait a few seconds for the editor to appear. Once it is ready, the button will become clickable.
If it stays disabled for a long time, try refreshing the page — the editor may have failed to load.
“I filled everything in but the form will not submit”
Check that all required fields are filled in: Title, Teaser, Cover Image, and at least one gym.
Look for small red error messages below fields — they tell you exactly what is missing.
Make sure you have uploaded a cover image. The form requires one.
“My cover image looks stretched or blurry”
The cover image is cropped to a 4:3 aspect ratio.
For best results, use an image that is at least 2048 × 1536 pixels.
If your original image is much smaller, it may appear blurry when displayed at larger sizes.
Try uploading a higher-resolution image.
“I do not see any gyms in the Available in gyms dropdown”
You must have at least one gym (location) set up in the system.
If you are new to the platform, create a gym first under the Gym settings.
If gyms exist but the list is empty, try refreshing the page — the gym data may not have loaded.
“My content in the visual editor disappeared”
The visual editor auto-saves its state within the session, but if you refresh the page or navigate away, unsaved content is lost.
Always click Add news to save your work before leaving the page.
If you accidentally navigated away, you will need to re-enter the content.
“I uploaded an image inside the content editor but it is not showing”
Images dragged into the content editor are uploaded automatically via the image service.
If the upload failed (for example, due to a slow connection), try removing the image block and adding it again.
Make sure the image file is not too large. Try compressing it before uploading.
“I see an error after clicking Add news”
A red error message will appear. Read it carefully — it usually explains the problem.
Common causes: a required field was missed, the server timed out, or the cover image upload failed.
If the error is unclear, try again. If it keeps happening, contact support with the error message.
“I want to schedule the article for later but it published immediately”
Make sure you set the Status to Planned, not Published.
If the status is set to Published, the article goes live right away regardless of the Published On date.
Double-check the date and time in the Published On picker to make sure it is set in the future.
“I cannot find my article after creating it”
Go to the News list from the left-hand menu.
If the article’s status is Draft, it may not appear in the default filtered view. Check if there is a filter or tab for drafts.
Make sure you are looking at the correct gym — articles are scoped to the gyms you selected in Available in gyms.
“Tags I typed are not saving”
After typing a tag, you must press Enter to add it as a chip.
If you just type text without pressing Enter, it will not be saved when you submit the form.
Check that the tag appears as a small colored chip in the field before saving.