***
title: "ProductVariantService"
generated: true
---------------
Contains methods relating to [ProductVariant](/current/core/reference/typescript-api/entities/product-variant#productvariant) entities.
```ts title="Signature"
class ProductVariantService {
constructor(connection: TransactionalConnection, configService: ConfigService, taxCategoryService: TaxCategoryService, facetValueService: FacetValueService, assetService: AssetService, translatableSaver: TranslatableSaver, eventBus: EventBus, listQueryBuilder: ListQueryBuilder, globalSettingsService: GlobalSettingsService, stockMovementService: StockMovementService, stockLevelService: StockLevelService, channelService: ChannelService, roleService: RoleService, customFieldRelationService: CustomFieldRelationService, requestCache: RequestContextCacheService, productPriceApplicator: ProductPriceApplicator, translator: TranslatorService)
findAll(ctx: RequestContext, options?: ListQueryOptions) => Promise>>;
findOne(ctx: RequestContext, productVariantId: ID, relations?: RelationPaths) => Promise | undefined>;
findByIds(ctx: RequestContext, ids: ID[]) => Promise>>;
getVariantsByProductId(ctx: RequestContext, productId: ID, options: ListQueryOptions = {}, relations?: RelationPaths) => Promise>>;
getVariantsByCollectionId(ctx: RequestContext, collectionId: ID, options: ListQueryOptions, relations: RelationPaths = []) => Promise>>;
getProductVariantChannels(ctx: RequestContext, productVariantId: ID) => Promise;
getProductVariantPrices(ctx: RequestContext, productVariantId: ID) => Promise;
getVariantByOrderLineId(ctx: RequestContext, orderLineId: ID) => Promise>;
getOptionsForVariant(ctx: RequestContext, variantId: ID) => Promise>>;
getFacetValuesForVariant(ctx: RequestContext, variantId: ID) => Promise>>;
getProductForVariant(ctx: RequestContext, variant: ProductVariant) => Promise>;
getSaleableStockLevel(ctx: RequestContext, variant: ProductVariant) => Promise;
getDisplayStockLevel(ctx: RequestContext, variant: ProductVariant) => Promise;
getFulfillableStockLevel(ctx: RequestContext, variant: ProductVariant) => Promise;
create(ctx: RequestContext, input: CreateProductVariantInput[]) => Promise>>;
update(ctx: RequestContext, input: UpdateProductVariantInput[]) => Promise>>;
createOrUpdateProductVariantPrice(ctx: RequestContext, productVariantId: ID, price: number, channelId: ID, currencyCode?: CurrencyCode, customFields?: CustomFieldsObject) => Promise;
deleteProductVariantPrice(ctx: RequestContext, variantId: ID, channelId: ID, currencyCode: CurrencyCode) => ;
softDelete(ctx: RequestContext, id: ID | ID[]) => Promise;
hydratePriceFields(ctx: RequestContext, variant: ProductVariant, priceField: F) => Promise;
applyChannelPriceAndTax(variant: ProductVariant, ctx: RequestContext, order?: Order, throwIfNoPriceFound: = false) => Promise;
assignProductVariantsToChannel(ctx: RequestContext, input: AssignProductVariantsToChannelInput) => Promise>>;
removeProductVariantsFromChannel(ctx: RequestContext, input: RemoveProductVariantsFromChannelInput) => Promise>>;
}
```
### findAll
\
RequestContext, options?: ListQueryOptions<ProductVariant>) => Promise<PaginatedListProductVariant>>>`} />
### findOne
\RequestContext, productVariantId: ID, relations?: RelationPaths<ProductVariant>) => PromiseProductVariant> | undefined>`} />
### findByIds
\RequestContext, ids: ID[]) => PromiseProductVariant>>>`} />
### getVariantsByProductId
\RequestContext, productId: ID, options: ListQueryOptions<ProductVariant> = {}, relations?: RelationPaths<ProductVariant>) => Promise<PaginatedListProductVariant>>>`} />
### getVariantsByCollectionId
\RequestContext, collectionId: ID, options: ListQueryOptions<ProductVariant>, relations: RelationPaths<ProductVariant> = []) => Promise<PaginatedListProductVariant>>>`} />
Returns a [PaginatedList](/current/core/reference/typescript-api/common/paginated-list#paginatedlist) of all ProductVariants associated with the given Collection.
### getProductVariantChannels
\RequestContext, productVariantId: ID) => Promise<Channel[]>`} />
Returns all Channels to which the ProductVariant is assigned.
### getProductVariantPrices
\RequestContext, productVariantId: ID) => Promise<ProductVariantPrice[]>`} />
### getVariantByOrderLineId
\RequestContext, orderLineId: ID) => PromiseProductVariant>>`} />
Returns the ProductVariant associated with the given [OrderLine](/current/core/reference/typescript-api/entities/order-line#orderline).
### getOptionsForVariant
\RequestContext, variantId: ID) => PromiseProductOption>>>`} />
Returns the [ProductOption](/current/core/reference/typescript-api/entities/product-option#productoption)s for the given ProductVariant.
### getFacetValuesForVariant
\RequestContext, variantId: ID) => PromiseFacetValue>>>`} />
### getProductForVariant
\RequestContext, variant: ProductVariant) => PromiseProduct>>`} />
Returns the Product associated with the ProductVariant. Whereas the `ProductService.findOne()`
method performs a large multi-table join with all the typical data needed for a "product detail"
page, this method returns only the Product itself.
### getSaleableStockLevel
\RequestContext, variant: ProductVariant) => Promise`} />
Returns the number of saleable units of the ProductVariant, i.e. how many are available
for purchase by Customers. This is determined by the ProductVariant's `stockOnHand` value,
as well as the local and global `outOfStockThreshold` settings.
### getDisplayStockLevel
\RequestContext, variant: ProductVariant) => Promise`} />
Returns the stockLevel to display to the customer, as specified by the configured
[StockDisplayStrategy](/current/core/reference/typescript-api/products-stock/stock-display-strategy#stockdisplaystrategy).
### getFulfillableStockLevel
\RequestContext, variant: ProductVariant) => Promise`} />
Returns the number of fulfillable units of the ProductVariant, equivalent to stockOnHand
for those variants which are tracking inventory.
### create
\RequestContext, input: CreateProductVariantInput[]) => PromiseProductVariant>>>`} />
### update
\RequestContext, input: UpdateProductVariantInput[]) => PromiseProductVariant>>>`} />
### createOrUpdateProductVariantPrice
\RequestContext, productVariantId: ID, price: number, channelId: ID, currencyCode?: CurrencyCode, customFields?: CustomFieldsObject) => Promise<ProductVariantPrice>`} />
Creates a [ProductVariantPrice](/current/core/reference/typescript-api/entities/product-variant-price#productvariantprice) for the given ProductVariant/Channel combination.
If the `currencyCode` is not specified, the default currency of the Channel will be used.
### deleteProductVariantPrice
\RequestContext, variantId: ID, channelId: ID, currencyCode: CurrencyCode) => `} />
### softDelete
\RequestContext, id: ID | ID[]) => Promise`} />
### hydratePriceFields
\RequestContext, variant: ProductVariant, priceField: F) => Promise<ProductVariant[F]>`} />
This method is intended to be used by the ProductVariant GraphQL entity resolver to resolve the
price-related fields which need to be populated at run-time using the `applyChannelPriceAndTax`
method.
Is optimized to make as few DB calls as possible using caching based on the open request.
### applyChannelPriceAndTax
\ProductVariant, ctx: RequestContext, order?: Order, throwIfNoPriceFound: = false) => Promise<ProductVariant>`} />
Populates the `price` field with the price for the specified channel.
### assignProductVariantsToChannel
\RequestContext, input: AssignProductVariantsToChannelInput) => PromiseProductVariant>>>`} />
Assigns the specified ProductVariants to the specified Channel. In doing so, it will create a new
[ProductVariantPrice](/current/core/reference/typescript-api/entities/product-variant-price#productvariantprice) and also assign the associated Product and any Assets to the Channel too.
### removeProductVariantsFromChannel
\RequestContext, input: RemoveProductVariantsFromChannelInput) => PromiseProductVariant>>>`} />