Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

  • Commerce

  • Customers

  • Staff

  • Merchants

    • Merchants

    • Merchant Custom Attributes

    • Locations

    • Location Custom Attributes

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Location Custom Attributes

Create and manage location-related custom attribute definitions and custom attributes.

Use the Location Custom Attributes API to create and manage custom attributes for locations. Custom attributes can be used to store properties or metadata that simplify integration, synchronization, and personalization workflows. After a custom attribute definition is created in a Square seller account, the custom attribute value can be set for locations.

For more information, see the following guides:

  • Location Custom Attributes
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

location.custom_attribute_definition.owned.created

Published when a location custom attribute definition is created by the subscribing application.

Beta

location.custom_attribute_definition.owned.deleted

Published when a location custom attribute definition created by the subscribing application is deleted

Beta

location.custom_attribute_definition.owned.updated

Published when a location custom attribute definition created by the subscribing application is updated

Beta

location.custom_attribute_definition.visible.created

Published when a location custom attribute definition that is visible to the subscribing application is created

Beta

location.custom_attribute_definition.visible.deleted

Published when a location custom attribute definition that is visible to the subscribing application is deleted

Beta

location.custom_attribute_definition.visible.updated

Published when a location custom attribute definition that is visible to the subscribing application is updated

Beta

location.custom_attribute.owned.deleted

Published when a location custom attribute owned by the subscribing application is deleted

Beta

location.custom_attribute.owned.updated

Published when a location custom attribute owned by the subscribing application is created or updated

Beta

location.custom_attribute.visible.deleted

Published when a location custom attribute that is visible to the subscribing application is deleted

Beta

location.custom_attribute.visible.updated

Published when a location custom attribute that is visible to the subscribing application is created or updated

Beta