Manage Products
Note
Your ability to create, edit, and view products on this page is tied to your role assignment in SwaggerHub. Learn more here.
Create New Product
To create a new product:
On the home screen, select Manage Products or the cog in the Products section.
Click Add Product.
Enter the name of the product.
Specify the product URL.
Click Create Product.
The new product is created and added to the product list.
Note
Selecting + Add Product automatically creates a new product and adds it to the product list. The default product name is: Product <next available product number>, for example: Product 19.
Open Live View
You can go to the live view from:
Home screen.
Portal configuration page.
Product content page.
Product settings page.
To go to the live view:
Select Portal Live View on your home screen.
Select Live View on the rest of the above pages.
Note
You cannot edit pages, or configure the portal or products in the consumer view.
Apply Changes
You can apply changes to:
Portal settings
Product settings
To apply changes:
Select Apply Changes.
Select Confirm.
The latest changes are applied.
Open Account Settings
To open account settings:
Select the account button.
In the modal window, select Manage My Account.
SmartBear ID opens in a new browser tab.
Set Product Name
To enter a product name:
On the home screen, select Manage Products or the cog in the Products section.
In the Product Name section, select the Product Name text field.
Enter the desired product name.
The product name is updated.
Note
The maximum length of the product name is 22 characters.
Set Product URL
Caution
Changing the product URL breaks links and bookmarks pointing to the product.
To set the product URL:
On the home screen, select Manage Products or the cog in the Products section.
In the Product URL section, select Edit.
In the pop-up window, enter the desired product URL in the text field.
The product URL is updated.
Set Product Description
To create or edit a product description:
On the home screen, select Manage Products or the cog in the Products section.
Choose the product from the list of products on the left.
In the Product Description section, select the Product Description text field.
Enter the product description.
Note
The maximum length of the product description is 110 characters.
Click Apply Changes.
The product description is updated.
Set Product Logo
To set the product logo:
On the home screen, select Manage Products or the cog in the Products section.
In the Product Logo section, select Upload.
In the pop-up window, select an image file.
Select Open.
The product logo is updated.
Set Product Visibility
To set the product visibility:
On the home screen, select Manage Products or the cog in the Products section.
In the Product Visibility section, select the radio button that corresponds to the desired visibility.
For a private product, select the toggle switch to set whether you want to show the product on the landing page.
The product visibility is updated.
Caution
Public products can contain private APIs. If a public product contains a private API, that private API is visible to everyone even if they are not given specific permissions at the organization or product level in SwaggerHub.
You are responsible for tracking the exposure of private APIs in your public products.
Note
Private products can only be accessed by members of the connected SwaggerHub organization. Ensure the relevant users are added to the SwaggerHub organization and have the organization-level or product-level role of consumer. Learn more here.
Product Tile Preview
It allows you to see the live preview of the product tile on the landing page. Read more about it here.
Delete Product
Caution
This action is permanent and cannot be undone.
Delete a product to:
Delete every documentation page from the product.
Unlink every API from the product.
Delete the active product from SwaggerHub Portal.
To delete a product:
On the home screen, select Manage Products or the cog in the Products section.
Choose the product to be deleted and select Delete Product at the bottom of the page.
Enter the product name to confirm product deletion.
Select Delete.
The product is permanently deleted from the product list.