--- title: Creating a new Catalog Item slug: v111/creating-a-new-catalog-item icon: {"faIcon":"fa-solid fa-cart-shopping"} docTags: createdAt: 2025-06-10T22:09:57.491Z --- # Overview Creating a catalog item in Servicely is an easy and quick way to gather structured information for any type of Record within the platform. Most commonly, Catalog Items are used to create Work Records (e.g., [ITSM Request](docId\:hY0luxi4KXMqJEsRXlLB6)) with additional information to ensure the record can be addressed quickly and efficiently. # Creating the Catalog Item :::::WorkflowBlock ::::WorkflowBlockItem ## Log into your instance as an Administrator :::hint{type="info"} Catalog Item development should be done in a subproduction environment within [Change Sets](docId\:cQVPZJ4tdVWuTt4Dj7NAn) to ensure migration between environments effectively. ::: :::: :::WorkflowBlockItem ## Type "Catalog item" ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/gOCBiDcgKujGWvhdHNrVr_ab-capture-image.png) ::: :::WorkflowBlockItem ## Click on [Catalog items](https://demo-master.servicely.ai/#/Portal/7f0000017157137481715813df431382) ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/CO0bq33gltdKQe29bX_8H_ab-capture-image.png) ::: :::WorkflowBlockItem ## Click on New to create a new Catalog Item ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/rvzW3A_2k21OKGVv3So2Y_ab-capture-image.png) ::: :::WorkflowBlockItem ## Populate the form to specify the Catalog Item's parameters The Name field will be shown to end users, and is indexed for search ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/Sf5steiLPql1LSYld5CeV_ab-capture-image.png) ::: :::WorkflowBlockItem The Category field allows you to specify where in the Portal [Catalog Categories](docId\:AEZuNMPB5wUyuJ2_jdg8u) the item will be visible. ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/B9zRZA2NV26I0PQt3SH5K_ab-capture-image.png) ::: :::WorkflowBlockItem Provide a summary - this is visible on the Catalog Item form ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/0_BJs_3OBJZ8_AXAwb5bd_ab-capture-image.png) ::: ::::WorkflowBlockItem Specify the Target Table - this is what Record will be created upon the submission of the form. :::hint{type="info"} In Servicely, Catalog Items can create *any *record! ::: ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/1_WFME-nB7bZfnZIo75Tj_ab-capture-image.png) :::: :::WorkflowBlockItem Poplulate the Name field - this is the form on the Record that will be populated with the Catalog Item's Name. In our example, this will be "Change Home Address" as set in **Step 5**. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/9hieNn5v2tD_VSizi3GdM_ab-capture-image.png) ::: :::WorkflowBlockItem ## When finished, hit Create to create the Catalog Item ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/dfi72tZDsE4LQc8R6Vk7W_ab-capture-image.png) ::: :::WorkflowBlockItem # Creating Catalog Item Questions Questions allow us to capture the specific information we need to automate or resolve the catalog item without needing additional details in follow-up messages. ::: :::WorkflowBlockItem ## On the Catalog Item, click New under the Question Items ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/XRXmTxfR-crjiZSqM7Wnt_ab-capture-image.png) ::: :::WorkflowBlockItem ## Provide the Question with a Unique Name This is the system name, and is used for any conditional logic or complex scripting. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/MwDkWx-504fbrMj4megY8_ab-capture-image.png) ::: :::WorkflowBlockItem ## Provide the question iteself This is the question that is visible to the end user. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/Ab3GRHAMkXtyLfEniP-nK_ab-capture-image.png) ::: :::WorkflowBlockItem ## Specify the Question Type In this example, we want to populate the field with the User who is submitting the quesiton, so we select the **Reference** field type ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/PYD7DxgyVaYE0s_RRT1Qz_ab-capture-image.png) ::: :::WorkflowBlockItem We can use the additional options under the field type to describe the fields behaviour: should it be **Readonly**, **Mandatory**, or invisible to the user (helpful for scripting)? ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/Aul9T8V-lPdGVlXLyHN8h_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/_UFkUAH1zcbs9eNwtV2rm_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/k2Lt9xy7T8ozb7TupWk0i_ab-capture-image.png) ::: :::WorkflowBlockItem ## For the Reference Field type, pick the Table we're referring to ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/CGZbOB-HIXNow4jKKtOEW_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/uw5a3ZKe2kmXbGiVhk43Q_ab-capture-image.png) ::: :::WorkflowBlockItem ## Determine how we're going to populate the record Our questions can be stored directly as Question Answers against the Record, or we can populate fields on the Record itself. In this example, we want the user who the form is being submitted for to be the **Requested For **on our HR Case Record. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/j99D1TWz6cIsEjM5ImhFD_ab-capture-image.png) ::: :::WorkflowBlockItem ## Question Data can also be Defaulted We can populate a Default field for any of the Question Types - Reference Fields against the User table can also be defaulted Dynamically from a function, meaning we can pre-populate the field to be the Current User. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/avxIHOOq3ZMdV4rNNhhxc_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/ZenosVwkAGrSUWzclALhH_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/kdOR0fBS9-lLBx8Dm-OLm_ab-capture-image.png) ::: :::WorkflowBlockItem ## When finished, click Create the populate the question ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/Z0lGclbGNOt1BUO6h9MnB_ab-capture-image.png) ::: :::WorkflowBlockItem ## Repeat for each additional Question ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/fE0TfrCQy0vdEJkeKgJrJ_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/NLnVesUrLvkCY_W_vDSAm_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/DLHuZst3UaZsV_l-H4AE1_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/OdQodju4DRo_OLsIwcIJD_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/QCCRYJqlmwHVBrvL5Tv1p_ab-capture-image.png) ::: :::WorkflowBlockItem # Previewing your Catalog Item Upon completion, ensure you hit **Save & Stay **to commit the changes to the system. ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/cZ1CZTES3uP2exPeai8UB_ab-capture-image.png) ::: :::WorkflowBlockItem ### To preview your Catalog Item, click the Preview button ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/4poM4ORBJCIPk2KkAVXWR_ab-capture-image.png) ::: :::WorkflowBlockItem ![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/kLOAbEWpCbyhCmh9yyDjF_ab-capture-image.png) ::: :::::