Documentation

Showcase page

Choose which programmes appear on your public page, and what a visitor sees there.

Your showcase page is a public page that lists the programmes you offer. It is for somebody deciding whether to enrol, not for checking a credential, and it never shows a person.

What a visitor sees

Page Address What it shows
Showcase /o/<your-slug> Your name and logo, and every programme you have listed
Programme /o/<your-slug>/p/<code> Title, description, skills, a learn-more link, and reviews
Check a credential /o/<your-slug>/verify A lookup with your name on it

These pages are served from the verification site, not from your dashboard, so they stay up and indexable on their own. In the dashboard, Catalogue → Showcase shows the exact links for your organisation and lets you copy or open each one.

Listing a programme

Every programme starts not listed. Open Catalogue → Showcase and, for each programme:

  • List on my showcase puts it on the page. Switch it off and it disappears.
  • Take reviews lets earners rate it from the link in their e-mail. It is on by default.
  • Skills are shown as tags. Separate them with commas; up to 20, 60 characters each. A repeated skill is dropped for you, ignoring capitals.
  • Learn-more link is shown as a button. It must start with https:// or http://.

Changes are saved per programme with the Save button. The button stays off until something actually differs from what is saved, so adding a trailing comma does not count as a change.

Archived programmes are not offered for listing.

What is never on the page

The showcase lists programmes only. There is no field on it that could carry a recipient, so it cannot publish a roster of named people, even by mistake. The only person-shaped detail anywhere is the first name of a reviewer, and only for a review that has not been flagged.

A reviewer can only be someone who holds a credential for the programme: the link in their e-mail carries a signed token.

Not listed and not found look the same

An unlisted programme, an archived one and one that does not exist all answer "not found". Telling them apart would reveal which programmes an issuer has chosen not to publish.

The check page keeps working

Your showcase goes dark if your account is suspended, because a prospectus is marketing. The check a credential page does not: a credential's verifiability is not a feature of your subscription. If your organisation cannot be resolved at all, /o/<slug>/verify still shows the plain lookup.

Through the API

# The manager's data: every live programme with its public profile, and where your pages live.
curl https://api.example.com/api/org/showcase -H "Authorization: Bearer $TOKEN"

# Change one programme's profile.
curl -X PUT https://api.example.com/api/org/groups/$GROUP_ID/profile \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"listed":true,"skills":["Python","SQL"],"learnMoreUrl":"https://example.org/courses/data"}'

# What a stranger sees. No authentication.
curl https://api.example.com/api/public/organizations/<your-slug>/showcase
curl https://api.example.com/api/public/organizations/<your-slug>/programmes/<code>

Both public responses accept ?lang= to return a published translation of a programme's title and description, falling back to the original text when none exists.