# Scopes

> The scopes an app can request and the descriptions shown to the store on the consent screen.

This page is generated from the source code. Apps request scopes in [`access_scopes.scopes`](app-toml.md); at install time the store owner sees these descriptions on the consent screen.

| Scope | What it grants |
| :--- | :--- |
| `read_companies` | View companies, their locations and their buyers; access the buyer's company during checkout. |
| `read_company_tax_ids` | View the unmasked 11-digit tax number (Turkish national ID) of sole proprietorships. |
| `read_customers` | View customers. Access to names and contact details depends on the app's customer data level. |
| `read_draft_orders` | View draft orders, their line items and their totals. |
| `read_gift_cards` | View gift cards and their balances (excluding card codes). |
| `read_inventory` | View stock quantities at each location. |
| `read_locations` | View inventory locations. |
| `read_marketing_audience` | View customers who consented to marketing (email or phone, name, language, consent date and source) and receive updates when consent is granted or withdrawn. Customers without consent or with erasure requests are excluded. |
| `read_metaobjects` | View custom data (metaobject) definitions and their entries. |
| `read_orders` | View orders, refunds, fulfillments and checkouts in progress. |
| `read_product_costs` | View product variant unit costs. |
| `read_products` | View products, variants, total stock and collections. |
| `read_translations` | View translations of products, collections, pages and menus. |
| `write_channels` | Open its own sales channel, publish products on it and create orders from it. |
| `write_checkout_functions` | Add shipping options and fees to checkout, and hide or reorder payment methods. |
| `write_companies` | Create, update and delete companies, company locations and buyers. |
| `write_customers` | Add tags to customers. |
| `write_discounts` | Create, update and delete discount codes; apply automatic discounts in checkout. |
| `write_draft_orders` | Create, update, delete and complete draft orders. |
| `write_emails` | Send emails to the store's buyers through the platform: the platform controls the sender and reply-to addresses, and the store's email limits apply. |
| `write_fulfillments` | Create fulfillments and update their tracking details. |
| `write_gift_cards` | Issue gift cards, update notes and expiry dates, and disable or re-enable cards. |
| `write_inventory` | Update stock quantities at each location and transfer stock between locations. |
| `write_marketing_consent` | Withdraw customers' marketing consent; record new consent with the wording and timestamp the customer agreed to. |
| `write_metaobjects` | Create, update and delete custom data definitions and entries; can alter storefront content. |
| `write_orders` | Add notes and tags to orders and cancel orders. |
| `write_payments` | Work as a payment method: receive payment, refund, capture and void requests and report their results. |
| `write_pixels` | View and update settings for the app's own web pixels (such as measurement IDs). |
| `write_products` | Add and update products. |
| `write_sms` | Send transactional SMS messages to customers about orders via the store's SMS provider; when acting as the SMS provider, send the store's SMS and report delivery status. |
| `write_theme_blocks` | Add app blocks and app embeds to the store's theme. |
| `write_translations` | Update translations of products, collections, pages and menus; can alter storefront text, including HTML descriptions. |
