Skip to main content

Edit a Quick Link

This is where you update an existing quick link. Quick links are shortcuts that appear in the mobile app so your members can quickly access external websites — things like your online store, a nutrition guide, or a member perks page. On this scree...

Written by Ronny Christensen
Updated over 3 weeks ago

What This Screen Does

This is where you update an existing quick link. Quick links are shortcuts that appear in the mobile app so your members can quickly access external websites — things like your online store, a nutrition guide, or a member perks page. On this screen you can change the link’s name, destination URL, and cover image.


How to Get There

  1. Open the dashboard.

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

  3. Find the quick link you want to edit in the list.

  4. Click on it (or click its edit action).

  5. You are now on the Edit Quick Link screen.


Step-by-Step Guide

1. Review the Breadcrumbs

  • At the top of the page you will see a breadcrumb trail: DashboardQuick Link[Quick Link Name].

  • This confirms you are editing the correct quick link.

Field

Required

What to Enter

Link Name

Yes

A short, descriptive name that members will see in the app (e.g., “Online Store”, “Nutrition Guide”, “Member Perks”). Keep it concise.

  • The current name is pre-filled from the existing quick link.

  • Edit it as needed.

3. Update the Destination URL

Field

Required

What to Enter

Destination URL

Yes

The full web address where members will be taken when they tap the link. It must start with http:// or https:// (e.g., https://example.com).

  • The current URL is pre-filled.

  • Make sure the new URL is valid and points to a live page.

4. Update the Cover Image

Field

Required

What to Enter

Cover Image

Yes

A thumbnail image displayed alongside the link name in the mobile app. Recommended aspect ratio is 4:3.

  • The current cover image is shown in the uploader.

  • To replace it, remove the existing image and upload a new one.

  • Click the image uploader area to select a file from your computer.

  • The image will be cropped to a 4:3 aspect ratio automatically.

  • Use an eye-catching visual that represents what the link leads to.

  • Only one cover image is allowed.

Note: The Available in Locations field that appears when creating a quick link is not shown on the edit screen. A quick link’s location assignment cannot be changed after creation.

5. Save Changes

  • Click the Save Changes button at the bottom-right of the form.

  • The system will:

    1. Validate all your inputs.

    2. Update the quick link record with the new name and URL.

    3. Upload the cover image (replacing the previous one).

    4. Navigate you back to the previous page.

  • 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 (name, URL, and cover image)
        |
        v
API call: QuickLinksService.edit({ id, body: { id, name, url } })
        |
        v
Quick link record is updated on the server
        |
        v
API call: QuickLinksService.addImage({ id, files: [coverImage] })
        |
        v
Cover image is uploaded and linked to the quick link
        |
        v
Success notification "Update success!" appears
        |
        v
You are navigated back to the previous page


Troubleshooting

“I changed the fields but the Save Changes button does nothing”

  • Make sure all required fields are filled in. The form will not submit if anything is missing.

  • Look for small red error messages below the fields — they tell you exactly what needs fixing.

  • The Link Name, Destination URL, and Cover Image are all required.

“The URL field shows an error”

  • The URL must be a complete web address starting with http:// or https://.

  • Double-check that you have not accidentally added spaces or special characters.

  • Example of a valid URL: https://www.example.com/store.

“My cover image did not upload”

  • The image must not exceed the maximum file size allowed by the system.

  • Make sure the file is a supported image format (JPEG, PNG, or GIF).

  • If the quick link was updated but the image failed, try editing the quick link again and re-uploading the image.

“I see an error message after clicking Save Changes”

  • A red error message will appear describing the problem. Read it carefully.

  • Common causes: the server could not be reached, the quick link no longer exists (it may have been deleted by someone else), or a required field was left empty.

  • Try refreshing the page and making your changes again. If the error persists, contact your administrator.

  • The page loads the quick link based on the ID in the URL. If the quick link data does not appear, the ID may be incorrect or the record may have been deleted.

  • Go back to the Quick Link list and click the correct quick link to edit it.

  • If the page is loading slowly, check your internet connection — the data is fetched from the server when the page opens.

  • The location assignment is set when the quick link is first created and cannot be changed on the edit screen.

  • If you need the link at a different location, create a new quick link for that location and delete the old one if it is no longer needed.

“The page keeps showing a loading state”

  • This usually means the API call to fetch the quick link data is taking too long or has failed.

  • Check your internet connection and try refreshing the page.

  • If the issue continues, the server may be experiencing problems — contact your administrator.

Did this answer your question?