> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vulpy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping options and tax in Vulpy Commerce

> Configure shipping profiles, rate providers, and tax providers in the Medusa admin so checkout returns accurate totals for every region.

Vulpy Commerce delegates shipping and tax calculation to Medusa v2. You configure both in the Medusa admin at `localhost:9000/app` for dev, or `api.<domain>/app` for live. This page shows how to set up shipping options and tax providers so every checkout returns the right totals.

<Tip>
  **The fastest way is to ask Fox.** Fox works in the same Medusa admin and can configure shipping and tax settings for you.

  * Add a flat-rate shipping option to the EU region.
  * Turn on tax provider X in staging first.
</Tip>

## Shipping concepts

Medusa uses three building blocks for shipping:

* **Shipping profiles** group products that share the same shipping requirements (for example, standard items versus oversized items).
* **Shipping options** price a shipment for a specific region and profile. Each option has a fulfillment provider, a price, and rules about when it applies.
* **Fulfillment providers** execute the actual shipment. Medusa ships with a manual provider, and you can add integrations for carriers.

## Add a shipping option

<Steps>
  <Step title="Open the Medusa admin">
    Go to `localhost:9000/app` in dev, or `api.<domain>/app` in live. Or just ask Fox to add the shipping option for you.
  </Step>

  <Step title="Pick a region">
    Navigate to **Settings → Regions** and select the region you want to configure.
  </Step>

  <Step title="Add a shipping option">
    Click **Add shipping option**. Choose a fulfillment provider, set the price, and link a shipping profile.
  </Step>

  <Step title="Save and test">
    Save the option, then start a checkout from the storefront to confirm the rate appears.
  </Step>
</Steps>

For details on fulfillment providers and shipping profiles, see the [Medusa fulfillment docs](https://docs.medusajs.com/resources/commerce-modules/fulfillment).

## Tax configuration

By default, Medusa calculates tax with a per-region rate. You set the rate when you create or edit a region in the admin.

If you need automated tax calculation, install a tax provider integration in `apps/medusa-backend`. Providers such as TaxJar or Avalara connect to live rate APIs. See the [Medusa tax docs](https://docs.medusajs.com/resources/commerce-modules/tax) for integration steps.

<Note>
  Tax provider credentials belong in `environments/<name>/.env`. Never commit them to version control.
</Note>

<Warning>
  Changing a region's tax provider after orders exist can produce inconsistent historical totals. Test any tax provider change in staging first.
</Warning>

<CardGroup cols={2}>
  <Card title="Payments" href="/shop/payments">
    Configure payment providers and test checkout flows in Medusa.
  </Card>

  <Card title="Orders" href="/shop/orders">
    View, manage, and fulfill orders from the Medusa admin.
  </Card>
</CardGroup>