Import Assets
After the catalog is created, the next step is adding products. This process starts by importing Jira Assets object schemas or object types that contain the product data.
A well-structured Assets setup with clear product details such as names, descriptions, images, prices, categories, and other relevant attributes is important for creating the best shopping experience.
Shop structure
After products are imported, the next step is defining the shop structure. This includes creating categories used in the shop view to organize products and make browsing easier for users. A clear structure improves navigation and helps users find products faster.
Click Edit Catalog button to open the catalog overview and start the initial setup.
Two import options are available when connecting Jira Assets to the catalog:
Import object schema: imports a complete object schema with all available object types. Before confirming the import, specific object types can be excluded if needed, providing flexibility during the initial setup.
Import object types: imports selected object types from one or multiple schemas. This option provides a more targeted approach and is commonly used later when adding new categories or expanding the existing catalog structure.
In both cases, object types can be added or removed later from different schemas, and child categories can be created as needed. This flexibility allows the catalog structure to be adjusted and expanded over time based on specific requirements.
Import object schema
When a complete object schema is imported, new object types added later are not included automatically. Manual updates are required to include newly created object types.
Products within already synced object types continue to update automatically.
Once the object schema is selected, the Assets tree is fetched and displayed. This provides an overview of all object types that will act as categories inside the shop. From this screen, object types or categories can be selected or deselected to control what is included in the catalog.
Import object types manually
Use this option when only a single object type needs to be added to the catalog, or when building a catalog with object types from multiple schemas.
Object schema: select the object schema from which object types will be imported.
Object type: select the object type to import as a catalog category.
AQL filter: optional Assets Query Language filter used to narrow the asset selection dynamically. This can improve the admin experience by displaying only relevant products. Example: show only products currently in stock using an inventory attribute such as: "In stock" != 0
AQL applied at the category level overrides the AQL set in the Create Catalog step, taking higher priority.