What This Screen Does
This is where you create a shortcut link that your members can see in the mobile app. Think of it like pinning a bookmark for your members — it could point to your online store, a nutrition guide, a signup page, or any website you want members to reach quickly. You give the link a name, a destination URL, a cover image, and choose which gym locations should display it.
How to Get There
Open the dashboard.
In the left-hand menu, click Quick Link.
Click the + New button (or equivalent create action) in the top-right corner.
You are now on the Create a New Quick Link screen.
Step-by-Step Guide
1. Enter the Link Name
Find the Link Name field under the Quick Link Configuration section.
Type a short, descriptive name for your link.
This is the text members will see in the mobile app, so keep it clear and concise.
Examples: “Online Store”, “Nutrition Guide”, “Member Perks”.
Field | Required | What to Enter |
Link Name | Yes | A short display name shown to members in the app (e.g. “Online Store”). |
2. Enter the Destination URL
In the Destination URL field, type the full web address where members will be sent when they tap the link.
The URL must start with
http://orhttps://.Example:
https://shop.example.com
Field | Required | What to Enter |
Destination URL | Yes | The full web address (e.g. |
3. Select Available Locations
Open the Available in Locations dropdown.
Check one or more gym locations that should display this quick link.
Members will only see links assigned to the location they are registered at.
The dropdown defaults to your currently selected gym.
You must select at least one location.
Field | Required | What to Enter |
Available in Locations | Yes | One or more gym locations where this link will appear. |
4. Upload a Cover Image
In the Cover Image section, click the upload area to open the image picker.
Select an image from your computer.
Crop it to a 4:3 aspect ratio (the cropper will guide you) and confirm.
The image appears as a thumbnail alongside the link name in the mobile app.
Use an eye-catching visual that represents where the link goes.
Only one cover image is allowed.
Field | Required | What to Enter |
Cover Image | Yes | One image file. Recommended aspect ratio is 4:3. |
5. Save
Click the Create button at the bottom-right of the form.
The system will:
Validate all your inputs.
Create a quick link record for each selected gym location.
Upload and attach the cover image to each quick link.
Navigate you back to the previous page.
You will see a green “Create success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Create"
|
v
Form validates all fields (Yup schema)
— Name must be filled in
— URL must be filled in
— At least one gym location must be selected
— Exactly one cover image must be provided
|
v
API call: QuickLinksService.create({ body: formData })
|
v
Server creates one quick link per selected gym location,
returns the list of new quick link records
|
v
For each new quick link:
API call: QuickLinksService.addImage({ id, files: [coverImage] })
|
v
Success notification appears ("Create success!")
|
v
You are navigated back to the previous page
Troubleshooting
“I filled everything in but the Create button does not work”
Make sure all required fields are filled in: Link Name, Destination URL, Available in Locations, and Cover Image.
Look for small red error messages below the fields — they tell you exactly what is missing.
The button is disabled while the form is submitting. If it stays disabled, check your internet connection and try again.
“The URL field shows an error”
The URL must be a complete web address, including the protocol.
Make sure it starts with
http://orhttps://.Correct:
https://shop.example.comIncorrect:
shop.example.comorwww.shop.example.com
“I do not see any gym locations in the dropdown”
Gym locations are loaded when you open the page. If the list is empty, try refreshing the page.
You must have at least one gym/location set up in the system before creating a quick link.
If you just created a new location, it may take a moment to appear. Refresh and try again.
“My cover image did not upload or shows an error”
Only one image is allowed. If you see an error about too many images, remove the extra one.
Make sure the file does not exceed the maximum file size allowed by the system.
Supported formats include JPEG, PNG, and GIF.
If the quick link was created but the image failed, go back to the quick link list, edit the link, and upload the image again.
“I got an error after clicking Create”
A red error message will appear. Read it carefully — it usually explains the problem.
Common causes: the server could not be reached (network issue), the URL is invalid, or a required field was left empty.
Try again after a few moments. If the error persists, contact your system administrator with the error message.
“I want the link to appear in all locations but I have many gyms”
You need to check each gym individually in the Available in Locations dropdown.
There is no “select all” shortcut — go through the list and check every location you need.
“I created the link but members cannot see it in the app”
Make sure the quick link is assigned to the correct gym location — members only see links for the location they are registered at.
The mobile app may need to refresh or be restarted for new links to appear.
Verify that the link was actually created by checking the Quick Link list page in the dashboard.
“I want to change the link after creating it”
You cannot edit from this screen. Go back to the Quick Link list and open the link you want to change.
From the edit screen you can update the name, URL, and cover image.
Note: the Available in Locations field is only shown during creation, not when editing.
