Skip to content
comrce Hubcomrce HubAdmin Guide

Create or edit a partner

For: comrce staff who run the Marketplace, and Marketplace partner usersRequires: The Admin, Super Admin or Marketplace Editor role; Marketplace Partner for own partnersScreenshots show sample data

A partner is the provider sellers end up contacting, such as the tax advisor Steuerkontor Hansen under VAT registration abroad. This form holds the partner’s listing data: placement, English texts, owner, contact data, sign-in client and visibility. The partner’s page itself is edited in the partner page editor.

Open the form from Marketplace with New partner on top or on a service. Each partner row opens it with Details.

What you can do here

Section titled “What you can do here”

The screen at a glance

Section titled “The screen at a glance”
The partner details tab for "Steuerkontor Hansen", opened with Details on its row in the Marketplace overview. Under "Partner details" the "Section" select shows "Tax and accounting" and the "Service" select "VAT registration abroad", each with a red info icon that warns about moving translations. Below are "English name" (Steuerkontor Hansen), the "Owner" select with Miriam Schulte and her e-mail address, the "Short description", "Website" with the firm's web address, "Contact email", "Contact phone" and the "OIDC client" select set to "Steuerkontor Hansen portal". The Visibility switch is on, and a note points to the page content editor. At the bottom, Reset and the highlighted "Save partner" button save the details and close the tab.The partner details tab for "Steuerkontor Hansen", opened with Details on its row in the Marketplace overview. Under "Partner details" the "Section" select shows "Tax and accounting" and the "Service" select "VAT registration abroad", each with a red info icon that warns about moving translations. Below are "English name" (Steuerkontor Hansen), the "Owner" select with Miriam Schulte and her e-mail address, the "Short description", "Website" with the firm's web address, "Contact email", "Contact phone" and the "OIDC client" select set to "Steuerkontor Hansen portal". The Visibility switch is on, and a note points to the page content editor. At the bottom, Reset and the highlighted "Save partner" button save the details and close the tab.
Partner details hold the listing data. The Owner field decides which partner user may edit this partner.
What this screenshot shows
Screen
Partner details
Highlighted
“Save partner”: saves the partner details and closes the tab
Also visible
Section Tax and accounting, service VAT registration abroad; Owner: Miriam Schulte; OIDC client: Steuerkontor Hansen portal; Visibility on
Purpose
Editing a partner with full Marketplace access
RegionWhat it showsWhat you do there
PlacementSection and ServiceChoose where the partner is listed
IdentityEnglish name, Owner (not for partner users), Short descriptionName the partner and give it an owner
ContactWebsite, Contact email, Contact phone, OIDC clientEnter how sellers reach the partner
Visibility and noteThe visibility switch and a pointer to the page content editorShow or hide the partner
FooterReset, Save partnerUndo or save

Create a partner

Section titled “Create a partner”
  1. On the overview, use New partner on the service where the partner belongs. Section and service are filled in. Or use New partner in the header and choose both yourself.
  2. Enter the English name and the Short description.
  3. Enter the Contact email, which is required. Add the website and phone if the partner wants them shown.
  4. Optional: choose an Owner and an OIDC client.
  5. Select Save partner. "Partner saved." appears, and the tab closes. Then open Content on the new partner to fill its page.
The Create partner tab opened from the service "Fulfilment centres", so "Section" already shows "Shipping and fulfilment" and "Service" shows "Fulfilment centres". "English name" holds "Elbe Fulfilment", the "Owner" select is empty with the placeholder "Select marketplace partner", and "Short description" reads "Small-parcel fulfilment from Hamburg for shops with up to 500 orders a day." "Website" holds the partner's web address, and the highlighted "Contact email" field holds anfrage@elbe-fulfilment.example.com; it is required and must be a valid address. "Contact phone" and "OIDC client" are still empty. Saving creates the partner without an owner, visible in the Marketplace.The Create partner tab opened from the service "Fulfilment centres", so "Section" already shows "Shipping and fulfilment" and "Service" shows "Fulfilment centres". "English name" holds "Elbe Fulfilment", the "Owner" select is empty with the placeholder "Select marketplace partner", and "Short description" reads "Small-parcel fulfilment from Hamburg for shops with up to 500 orders a day." "Website" holds the partner's web address, and the highlighted "Contact email" field holds anfrage@elbe-fulfilment.example.com; it is required and must be a valid address. "Contact phone" and "OIDC client" are still empty. Saving creates the partner without an owner, visible in the Marketplace.
Starting from a service panel preselects its section and service. Name, short description and contact email are required.
What this screenshot shows
Screen
Create partner
Highlighted
“Contact email”: the partner's contact address, required
Also visible
Section and service preselected; English name Elbe Fulfilment; Owner empty
Purpose
Adding a partner from a service, with section and service filled in

comrce Hub derives the partner’s key from the English name, for example steuerkontor_hansen. The key is unique within its service. A new partner has no page content yet. Until the page is filled, sellers who open it see only the listing data.

Required fields

Section titled “Required fields”
The Create partner form, opened from the service "Fulfilment centres", after selecting Save partner with the text fields empty. "Section" shows "Shipping and fulfilment" and "Service" shows "Fulfilment centres", so they pass. Red messages appear under the other required fields: "English name is required." under the highlighted "English name" field, "Short description is required." and "Contact email is required". Owner, Website, Contact phone and OIDC client are optional and show no message; the Visibility switch is on. Nothing is saved until the required fields are filled.The Create partner form, opened from the service "Fulfilment centres", after selecting Save partner with the text fields empty. "Section" shows "Shipping and fulfilment" and "Service" shows "Fulfilment centres", so they pass. Red messages appear under the other required fields: "English name is required." under the highlighted "English name" field, "Short description is required." and "Contact email is required". Owner, Website, Contact phone and OIDC client are optional and show no message; the Visibility switch is on. Nothing is saved until the required fields are filled.
Section, service, English name, short description and contact email are required before a partner can be saved.
What this screenshot shows
Screen
Create partner
Highlighted
“English name”: the message disappears once you type a name
Also visible
Section and service preselected; Messages under English name, Short description and Contact email
Purpose
What the partner form says when required fields are empty
FieldRuleMessage
SectionRequired"Section is required."
ServiceRequired"Service is required."
English nameRequired, up to 80 characters, no HTML"English name is required."
Short descriptionRequired, up to 180 characters, no HTML"Short description is required."
Contact emailRequired, valid address, up to 128 characters"Contact email is required" or "Contact email must be a valid email address."
WebsiteOptional. Starts with http:// or https://, up to 128 characters"URL must use HTTP or HTTPS"
Contact phoneOptional, up to 32 characters"Must be at most 32 characters"

Assign or change the owner

Section titled “Assign or change the owner”

As a Super Admin, Admin or Marketplace Editor, you can assign an owner to any partner. The owner can be any user with the Marketplace Partner role. Partner users cannot assign or change owners. The Owner select shows each user’s name and email. You can search it and clear it.

ChoiceEffect
A partner userThat user sees this partner in their Marketplace view. They can edit, translate and delete it.
EmptyOnly comrce staff can maintain the partner
Another partner userThe previous owner loses access at once, and the new one gains it

If the owner loses the Marketplace Partner role, comrce Hub clears their ownership. When an owner saves changes themselves, every user with the Marketplace Editor role gets an email about it.

The Create partner tab as the Marketplace partner user Miriam Schulte sees it; the sidebar shows only Marketplace. The form has no Owner field: the highlighted "English name" field, filled with "Steuerkontor Hansen Payroll", and "Short description" sit side by side in one row. Section and Service are empty selects; they only offer sections and services that are visible in the Marketplace. Website, Contact email, Contact phone, OIDC client and the Visibility switch follow as in the full form. When she saves, comrce Hub makes her the owner automatically and e-mails everyone with the Marketplace Editor role about the new listing.The Create partner tab as the Marketplace partner user Miriam Schulte sees it; the sidebar shows only Marketplace. The form has no Owner field: the highlighted "English name" field, filled with "Steuerkontor Hansen Payroll", and "Short description" sit side by side in one row. Section and Service are empty selects; they only offer sections and services that are visible in the Marketplace. Website, Contact email, Contact phone, OIDC client and the Visibility switch follow as in the full form. When she saves, comrce Hub makes her the owner automatically and e-mails everyone with the Marketplace Editor role about the new listing.
Partner users get the same form without the Owner field. Whatever they create belongs to them.
What this screenshot shows
Screen
Create partner
Highlighted
“English name”: name of the new partner
Also visible
Signed in with the Marketplace Partner role; No Owner field; English name and Short description in one row
Purpose
A partner company adding its own listing

A partner user who opens this form sees no owner field. English name and short description share one row. Section and service offer only visible sections and services. Whatever they create belongs to them.

Every control, explained

Section titled “Every control, explained”

OIDC client

Section titled “OIDC client”
Where
Next to Contact phone.
What
A searchable select of confidential sign-in clients, shown as display name and client ID. Optional and clearable. You manage the clients under API keys.
Why
Connects the partner’s own app. After installing the partner, a seller can sign in to that app with their comrce Hub account.

Owner

Section titled “Owner”
Where
Next to the short description. Partner users do not see it.
What
One user with the Marketplace Partner role, or none. If the current owner no longer has that role, the select still shows them until you change it.
Why
Lets an external partner maintain their own listing without access to anything else.

Section and Service

Section titled “Section and Service”
Where
The first row of the form. Both required.
What
  • The section list shows all sections for staff with full Marketplace access. Partner users see only sections with a visible service.
  • The service list shows the services of the chosen section. It stays disabled until a section is chosen. Changing the section clears a service that is not in it.
  • Moving: an existing partner shows a red info icon next to the fields. Its warning reads: "Changing this selection changes the translation path for the partner and overwrites the existing marketplace translations for its page content." Saving a new placement moves the partner’s texts in every language to the new path. Anything already there is replaced.
Why
The placement decides where sellers find the partner.

Visibility

Section titled “Visibility”
Where
The switch below the contact fields.
What
On by default. Off hides the partner from sellers, and the overview shows a crossed-out eye.
Why
Prepare a partner, or take it offline without deleting its page.

Website, Contact email, Contact phone

Section titled “Website, Contact email, Contact phone”
Where
The two rows below the identity fields.
What
All three appear on the partner’s page for sellers. Only the contact email is required. When the partner has an OIDC client, sellers see the website link only after they installed the partner. Visitors without an account then do not see it at all. The limits are in Required fields.
Why
Sellers contact partners directly. comrce does not relay messages.

Short description

Section titled “Short description”
Where
Next to the owner, or next to the name for partner users.
What
Required, no HTML. Shown under the partner’s name in the Marketplace list. The limit is in Required fields.
Why
One line that tells a seller why to open this partner.

English name

Section titled “English name”
Where
Below the placement.
What
Required, no HTML. Shown as the partner’s name. On a new partner it also produces the key.
Why
The name sellers recognise and search for.

Other controls on this page

ControlWhat it doesWhy
ResetRestores the values the form opened withStart over after an experiment
Save partnerChecks and saves the form, then closes the tabMakes the change live

What you need to know

Section titled “What you need to know”
TopicFact
LimitsSee Required fields.
TextsEnglish only. Other languages come from the translations CSV.
OwnershipOne owner per partner. Cleared when the owner loses the partner role.
EmailsChanges saved by an owner notify everyone with the Marketplace Editor role.
AuditPartner created, updated and deleted are in the audit trail.

Frequently asked questions

Section titled “Frequently asked questions”

General

Section titled “General”
Section titled “Where do I write the partner’s about text and upload its logo?”

Not in this form. Save the partner, then select Content on its row in the Marketplace overview. The partner page editor holds the logo, about text, filters, info rows and cards.

Why is the Service list greyed out?

Section titled “Why is the Service list greyed out?”

The service list in the partner form stays disabled until you choose a section. It only offers the services of that section. Choose the section first. If you started from a service panel, both are already filled in.

Can I write the partner’s name in German?

Section titled “Can I write the partner’s name in German?”

No. The form takes the English name only. Other languages come from the Marketplace translations CSV, with a name key per partner. Missing translations fall back to English for sellers.

Ownership

Section titled “Ownership”

Who can be chosen as owner?

Section titled “Who can be chosen as owner?”

Only users with the Marketplace Partner role. Invite them in Hub Team first. The list is sorted by first name and shows each user’s name and email. You can type to search it.

What happens when I take the partner role away from an owner?

Section titled “What happens when I take the partner role away from an owner?”

comrce Hub clears that user’s ownership of every partner. The partners stay listed. Only comrce staff can maintain them until you assign a new owner in the partner form.

Can a partner user hand their partner over to someone else?

Section titled “Can a partner user hand their partner over to someone else?”

No. Partner users do not see the owner field, so they cannot change the owner. A user with the Marketplace Editor, Admin or Super Admin role assigns the new owner.

Contact and sign-in

Section titled “Contact and sign-in”

Why does a seller not see the partner’s website?

Section titled “Why does a seller not see the partner’s website?”

With an OIDC client linked, the website link appears only after the seller installed the partner. Visitors without an account do not see it. Without a sign-in client, every seller and visitor sees the website. Also check that the website field is filled in.

What is the OIDC client for?

Section titled “What is the OIDC client for?”

It links the partner to a sign-in client registered under API keys. Sellers who install the partner can then sign in to its app with their comrce Hub account. Leave it empty for partners that offer a service rather than an app.

Troubleshooting

Section titled “Troubleshooting”
SymptomWhat to check
"Failed to save partner." when saving as a partner userThe chosen service may be hidden, or the partner belongs to another user. Partner users can only use visible services and their own partners.
The owner list is emptyNo user has the Marketplace Partner role. Invite one in Hub Team.
The form opened empty for an existing partnerThe partner was deleted. Or you are a partner user and opened a partner you do not own. Close the tab and reload the overview.
"URL must use HTTP or HTTPS"Add https:// in front of the website.
The OIDC client list says "Loading clients..." for longThe sign-in client list could not be loaded. Reload the tab.
Section titled “Related”