Custom Shop Items

1 The list

Click Add new Shop Item to create one, or the name or Edit to change it. The list can be exported to CSV. The ServiceNow toggle saves at once.

2 Properties

The Properties tab of a custom shop item: load properties from, name, manufacturer, short description, description, price, software variables, administrator comments, categories, security and deep link — Properties. Only the name is required.

Field	What it does
Load properties from	Copies the settings of an existing item as a starting point.
Name, Manufacturer	The name shoppers see, and a manufacturer for the filter.
Short Description, Description	As for applications; the description can contain HTML.
Price	A price, or Free, Unknown, per year, per month or a one-time cost.
Show Software Variables	The questions the shopper answers — for hardware, for example the model or the delivery address.
Administrator comments	Never shown in the shop.
Product Categories	Where it is listed.
Security	Allow all users to order this item, or only the members of the chosen Package Security Groups. Allowed to order on computer and on mobile. Only show and hide order button shows the item without a way to order it — for information only.
Deep Link	A link straight to the item in the shop.

3 The other tabs

Tab	What it does
Icon, Additional Languages	As for applications — see Software Administration.
Action	The scripts that do the work: when the item is ordered, and when it is approved or declined. See Custom Actions.
Approval Flow	Who approves — Approval Flow.
Additional Information	Contacts, tags and info fields.

The Action tab of a custom shop item with a script for when the item is ordered and one for when it is approved or declined — Action.

4 In the shop

A custom item appears as a normal card. Its button is Order — or your own text, set under Settings › Shop › Install button text — and it can be ordered, approved and followed like any application. It cannot be uninstalled or repaired.

5 Examples

6 Best practice

Give each item a unique name. SoftwareCentral refuses a name that another shop item already has.
Keep the name and the short description short. Together they must stay within 251 characters.
Check the Run as accounts of the Action tab before you save. A wrong password stops the item from being saved. See Custom Actions.

7 Troubleshooting

Symptom	Cause	What to do
“Name can not be empty.”	The Name box is empty.	Enter a name.
“Name does already exist.”	Another shop item has the same name.	Choose a different name.
“Length of name and short description can only be 251 characters combined.”	The name and the short description together are too long.	Shorten the name or the short description.
“Something went wrong saving this item. See the log for details.”	An unexpected error stopped the save.	Open the Log, find the entry “Failed to save shop item.”, and read the error in it.