Manage billing in your account

This page describes how to manage billing for your LangSmith organization:

• Set up billing for your account: Complete the billing setup process for Developer and Plus plans, including special instructions for legacy accounts.
• Update your information: Modify invoice email addresses, business information, and tax IDs for your organization.
• Enforce spend limits: Learn how to manage your spend through usage limits and data retention.

​

Set up billing for your account

To set up billing for your LangSmith organization, navigate to the Billing and Usage page under Settings. Depending on your organization’s settings, there are different setup guides:

• Developer plan
• Plus plan

​

Developer Plan: set up billing on your personal organization

Personal organizations are limited to 5,000 traces per month until a credit card is added. To add a card:

1. Click Add card to remove trace limit.
2. Add your credit card information.
3. Once complete, you will no longer be rate limited to 5,000 traces, and you will be charged for any excess traces at rates specified on the pricing page.

​

Plus Plan: set up billing on a shared organization

Team organizations are given an initial 10,000 traces per month. Any excess traces will be charged at rates specified on the pricing page.

1. Click Upgrade to Plus.
2. Invite members to your organization, as desired.
3. Enter your credit card information. Then, enter business information, invoice email, and tax ID. If this organization belongs to a business, check the This is a business checkbox and enter the information accordingly. For more information, refer to the Update your information section.

​

Update your information (Paid plans only)

To update business information for your LangSmith organization, head to the Billing and Usage page under Settings.

​

Invoice email

To update the email address for invoices, follow these steps:

1. Navigate to the Plans and Billing tab.
2. Locate the section beneath the payment method, where the current invoice email is displayed.
3. Enter the new email address for invoices in the provided field.
4. The new email address will be automatically saved.

You will receive all future invoices to the updated email address.

​

Business information and tax ID

To update your organization’s business information, follow these steps:

1. Navigate to the Plans and Billing tab.
2. Below the invoice email section, you will find a checkbox labeled Business.
3. Check the Business checkbox if your organization belongs to a business.
4. A business information section will appear, allowing you to enter or update the following details:
   • Business Name
   • Address
   • Tax ID for applicable jurisdictions
5. A Tax ID field will appear for applicable jurisdictions after you select a country.
6. After entering the necessary information, click the Save button to save your changes.

This ensures that your business information is up-to-date and accurate for billing and tax purposes.

​

Enforce spend limits

​

Understand your current usage

The first step of any optimization process is to understand current usage. LangSmith provides two ways to do this: Usage graph and Invoices. LangSmith Usage is measured per workspace, because workspaces often represent development environments (as in the example), or teams within an organization.

​

Usage graph

The usage graph lets you examine how much of each usage-based pricing metric you have consumed. It does not directly show spend (which you will review later in the draft invoice). Navigate to the usage graph under Settings -> Billing and Usage -> Usage Graph. There are two usage metrics that LangSmith charges for:

• LangSmith Traces (Base Charge): tracks all traces that you send to LangSmith.
• LangSmith Traces (Extended Data Retention Upgrades): tracks all traces that also have our Extended 400 Day Data Retention.

For more details, refer to the data retention conceptual docs.

​

Invoices

To understand how your usage translates to spend, navigate to the Invoices tab. The first invoice that will appear on screen is a draft of your current month’s invoice, which shows your running spend thus far this month.

​

Set limits on usage

​

Set spend limit for workspace

1. To set limits, navigate to Settings -> Billing and Usage -> Usage limits.
2. Input a spend limit for your selected workspace. LangSmith will determine an appropriate number of base and extended trace limits to match that spend. The trace limits include the free trace allocation that comes with your plan (see details on pricing page).

​

Configure trace tier distrubution

LangSmith has two trace tiers: base traces and extended traces. Base traces have the base retention and are short-lived (14 days), while extended traces have extended retention and are long-lived (400 days). For more information, refer to the data retention conceptual docs. Set the desired default trace tier by selecting an option below the Default data retention label. All traces will have this tier by default when they are registered. Note that because extended traces cost more than base traces, selecting Extended as your default data retention option will result in less overall traces allowed in the billing period. By default, updating this setting will only apply to future incoming traces. To apply to all existing traces in the workspace, select the checkbox. If the default data retention is set to Base you can optionally use the slider to distribute trace limits across base and extended tracess. LangSmith automatically provides a suggestion for this distribution but you can tailor this to your needs. For example, if you are running lots of automations or other features that may upgrade a trace to extended, you may want to increase your extended trace limits. To see the complete list of features that may upgrade a trace, see here.

​

Other methods of managing traces

​

Change project-level default retention

Data retention settings are adjustable per tracing project. Navigate to Projects > Your project name > Select Retention and select the desired default retention. This will only affect retention (and pricing) for traces going forward.

​

Apply extended data retention to a percentage of traces

You may not want all traces to expire after 14 days. You can automatically extend the retention of traces that match some criteria by creating an automation rule. You might want to apply extended data retention to specific types of traces, such as:

• 10% of all traces: For general analysis or analyzing trends long term.
• Errored traces: To investigate and debug issues thoroughly.
• Traces with specific metadata: For long-term examination of particular features or user flows.

To configure this:

1. Navigate to Projects > Your project name > Select + New > Select New Automation.
2. Name your rule and optionally apply filters or a sample rate. For more information on configuring filters, refer to filtering techniques.

For example, this is the expected configuration to keep 10% of all traces for extended data retention: If you want to keep a subset of traces for longer than 400 days for data collection purposes, you can create another run rule that sends some runs to a dataset of your choosing. A dataset allows you to store the trace inputs and outputs (e.g., as a key-value dataset), and will persist indefinitely, even after the trace gets deleted.

​

Summary

If you have questions about further managing your spend, please reach out to support@langchain.dev.

---