Using Custom Fields

Stockist comes with built-in fields that you can set for each store, like a name, address, phone number, and website. But what if you need to list other information like a fax number, a Facebook page, store hours, or something else?
That's where custom fields come in - you can create your own fields that will show up alongside the built-in ones. When you create a field, you pick the name that'll appear for all stores (e.g. "Fax Number" or "Facebook Page"), and then you can set separate text/links for each location.

Custom field basics

A custom field represents an extra slot for information that you can fill out for any of the locations on your map. You first create a custom field in your Stockist account by choosing a name for the field and how the field will display on your map. Once the field has been created, you can add different text or links in the field for each store in your account.
Among other things, custom fields are commonly used to show:
  • A Facebook or Instagram profile link
  • A fax number
  • A booking or reservation link
  • The name of a manager or representative

How custom fields appear

When creating a custom field, you can choose how the field will appear on your map. The options are:

Text (single-line)

The custom field will show a single line of text, labelled with the field name:

Editing in the dashboard
Displayed on your map

Text (multi-line)

The custom field will show text including any line breaks, labelled with the field name:

Editing in the dashboard
Displayed on your map

Link

The custom field will show a link. The field name will show as the link text, and you can specify a separate URL for each store to be the link destination:

Editing in the dashboard
Displayed on your map

Common tasks

Create a field

To create a custom field in your account, open the Settings > Custom Fields page of the Stockist dashboard, then click Add custom field and fill out the form that appears:

In the Field name box, enter the name for the field that will appear to visitors on your map. Under Field type, choose how the field should display (see the examples earlier in this article). In the Visibility section, choose whether the field should appear to visitors or remain hidden for now:

Re-order fields

To change the display order of your fields, open the  Settings > Custom Fields page of the dashboard and drag-and-drop the handle of the field you'd like to move:

Set the field value for a location in the dashboard

Once a custom field has been created, you can set the value for any or all of the stores in your account. When adding or editing a store, a box will appear for each custom field where you can enter the relevant text or URL:

When you're done, click Save to update the location.

Set field values in bulk when importing a spreadsheet

To apply custom fields when importing locations from a spreadsheet, add an additional column to your spreadsheet for each custom field you've created in your account. The order of the columns doesn't matter.
In the heading row of the new column, enter the name of the custom field. In each store row, enter the appropriate value for each field (or leave the cell blank if the field doesn't apply).

For example, if you had custom fields called "My Custom Field" and "Book now", your spreadsheet might look like this:

When importing your spreadsheet in the app dashboard, on the Identify Columns step, be sure the columns in your file are set to import to the relevant fields in Stockist: