Custom fields let you collect and store more about your sellers that is relevant for your business. For example, you might want to record information about seller delivery days, cut-off times, additional contact people, alternate return addresses, or other kinds of details.
You can assign default values to custom fields. These default values are currently only available and visible in the API and UI.
Custom fields are:
- visible in all seller profiles (editable by you) and the Seller portal (editable by each seller).
- grouped in sections that you also create and define. You can create as many sections for custom fields as you like.
- currently available as text fields, numeric fields (integer and decimal), date and time fields, boolean (true/false), email and URL fields, and single-select and multi-select fields.
- able to be defined as mandatory or optional.
- can be assigned default values.
- can be ordered by assigning a position index.
Personally Identifiable Information
Custom fields must not be used to store personal data. It is the customer's responsibility to ensure that no personal data, sensitive data, export-controlled data, or other regulated data is entered into any custom field when using the Marketplacer service.
Create and edit custom fields and custom field groups
Custom fields and custom field groups can only be added via the GraphQL API. This means you will need a developer’s help to implement. See the full instructions for the customer field mutations and queries in our API documentation.
Editing custom fields in the Operator portal
- Sign in to the Operator portal.
- Select MANAGE SELLERS from the side nav.
- Select a seller and click the edit button beside the account name.
- Click the Edit custom fields button.
- A screen displays where you can assign default values for payment providers and other additional details.
- Click Update to save changes.
Working with custom fields
Once you have created the custom fields you want, they will become visible in several places:
-
Each existing seller’s profile and the Create Seller window when you add new sellers (visible to you). See example below.
-
The Account Settings window in the seller portal (visible to all sellers). See example below.
Show and hide custom fields in the Sellers list
By default, the new custom fields do not appear in the main Sellers list. If you want to show them:
- Go to Sellers > Manage Sellers.
- Select Show/Hide table columns.
- In the selection window, scroll to the bottom to find your custom fields.
- Select the ones you want to be visible and select Save. The new custom fields appear in the far right.
Export and import custom fields with seller information
If you want to add information to custom fields in bulk, you can download all your seller information in a csv file and edit it in Excel, then upload again.
When you download the seller details file, the custom fields appear in the far right columns.
Depending on the custom field type, a specific format will be required:
- Integer: Whole numbers only, e.g. 1
- Decimal: Whole numbers or decimal numbers, e.g. 1 or 1.5
- Date: Date formatted as dd Mmm yyyy, e.g. 25 Dec 2024
- Time: Time formatted as hh:mm, e.g. 03:00, 14:00, etc.
- Single-select: A single value from the given list of options in the following format: ["value1"]
- Multi-select: A single or multiple values from the given list of options in the following format: ["value1"], ["value1", "value5", "value10"], etc.
Please note: The formatting of values in exported spreadsheets may depend on how the spreadsheet was opened, e.g. excel may change the formatting of the date from 25 Dec 2024 to e.g. 25-Dec-24 or similar. To be able to reimport the values, they need to match the format given above.
Export seller details
- Go to the Sellers list by selecting Sellers > Manage Sellers.
- Scroll to the bottom of the table and select Download as CSV.
- All your seller information is downloaded in a spreadsheet.
- Scroll to the very far right to see the custom field columns.
- Add or edit information and then import it back into Marketplacer.
Import seller details
- Go to the Sellers list by selecting Sellers > Manage Sellers.
- Select Import Sellers.
- In the next screen at step 2, select Choose File, then select the CSV you have edited.
- Select Upload. Any information you added to the spreadsheet is uploaded and the custom fields are populated.
Related articles