Skip to main content

Create a New Quick Link

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 ...

Written by Ronny Christensen
Updated over 3 weeks ago

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

  1. Open the dashboard.

  2. In the left-hand menu, click Quick Link.

  3. Click the + New button (or equivalent create action) in the top-right corner.

  4. You are now on the Create a New Quick Link screen.


Step-by-Step Guide

  • 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:// or https://.

  • Example: https://shop.example.com

Field

Required

What to Enter

Destination URL

Yes

The full web address (e.g. https://example.com). Must be a valid URL.

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:

    1. Validate all your inputs.

    2. Create a quick link record for each selected gym location.

    3. Upload and attach the cover image to each quick link.

    4. 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:// or https://.

  • Correct: https://shop.example.com

  • Incorrect: shop.example.com or www.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.

  • 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.

  • 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.

  • 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.

Did this answer your question?