---
title: useAttributeValues
description: Returns the values for the specified `attributes` applied to the checkout.
api_version: 2023-04
api_name: checkout-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2023-04/react-hooks/attributes/useattributevalues
  md: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2023-04/react-hooks/attributes/useattributevalues.md
---

# use​Attribute​Valueshook

Returns the values for the specified `attributes` applied to the checkout.

## use​Attribute​Values([keys](#-propertydetail-keys)​)

### Parameters

* keys

  string\[]

  required

  An array of attribute keys.

### Returns

* (string | undefined)\[]

### Examples

* #### Attribute values

  ##### React

  ```jsx
  import React from 'react';
  import {
    Text,
    render,
    useAttributeValues,
  } from '@shopify/checkout-ui-extensions-react';

  render('Checkout::Dynamic::Render', () => (
    <Extension />
  ));

  function Extension() {
    const [buyerSelectedFreeTShirt, tshirtSize] =
      useAttributeValues([
        'buyerSelectedFreeTShirt',
        'tshirtSize',
      ]);

    if (Boolean(buyerSelectedFreeTShirt) === true) {
      return (
        <Text>
          You selected a free t-shirt, size:{' '}
          {tshirtSize}
        </Text>
      );
    }

    return null;
  }
  ```

## Related

[APIs - StandardApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/standardapi)

[APIs - CheckoutApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/checkoutapi)

[APIs - OrderStatusApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/orderstatusapi)

[APIs - CartLineDetailsApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/cartlinedetailsapi)

[APIs - PickupPointsApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/pickuppointsapi)

[APIs - PickupLocationsApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/pickuplocationsapi)

[APIs - ShippingMethodDetailsApi](https://shopify.dev/docs/api/checkout-ui-extensions/apis/shippingmethoddetailsapi)

[APIs - ExtensionPoints](https://shopify.dev/docs/api/checkout-ui-extensions/apis/extensionpoints)