Category Configuration
Each category in Shoppie requires its own setup in the Settings tab. This is necessary to provide more flexibility in how categories are managed and displayed, but also due to certain technical limitations on the Atlassian side that prevent shared configuration across categories.
The "Settings" tab is divided into four sections, each offering specific configuration options: Default Attributes, Category Details, Product Settings, and Advanced Settings.
Category Image
Product images are managed through Jira Assets. The displayed image is the product’s avatar, which can be added directly in Assets. More details are available on this page → Display Options (Products) | Product Image.
The category image appears on the landing page when the shop catalog opens. It is selected from one of the product images within the category. If none of the products have an image, a default image will be shown instead.
Default Attributes
Two key attributes are defined in this section:
Name (Required): Serves as the product name displayed in the shop.
Price (Optional): Only float and integer attributes are available for price selection. Can remain empty.
Category Details
In Category details, options specific to each category can be customized:
Name and icon: These are fetched from Assets but can be changed.
Limit to one item selection: Restrict the selection to only one item per category.
No price text: Customize the text displayed for items without a price (e.g., "Free," "No Price," or leave it blank to show nothing).
Product Settings
In the Product settings section, you can configure optional settings that enhance how products are displayed and managed within a category. These options help provide a better user experience and ensure accurate information is shown.
In stock: Configures an attribute to automatically update stock status, showing information like "Out of Stock," "Pre-order," or "Only 4 left." Provides users with real-time inventory updates.
Recommended products: Displays related products in the product details view and cart, offering suggestions for complementary items and enhancing the shopping experience.
More details about both features on dedicated pages.
Advanced settings
Advanced settings provides additional customization options to accommodate advanced use cases and scenarios.
Object schema and object type: These are used for informational purposes and cannot be edited here. They are defined during the catalog creation process, where assets are synced with the catalog.
Custom field to map to: Map the category to an existing Assets custom field. Multiple object types can be assigned to a category. Objects from this category will be saved in the specified 'Assets' custom field when a customer request is submitted. This is particularly useful for REST API integrations and automation.
Category-level AQL: An AQL filter can be added at the category level, giving admins the option to override the global AQL defined during catalog creation or retain it.
