---
schema_version: "1"
id: 89674f751fe8170b456c1837c44fa8ba1ecfb98a13e955f25effc56e330ea1f9
title: CompanySettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_companyprofilesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_companyprofilesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 5cc3fd115d3f3d55ed76ef55f1852e0292c45ecd6e6d1bd8aad02192a6219f6f
description: Represents global settings that affect multiple features in your organization. This type extends the Metadata metadata type and inherits its fullName field.
---
# CompanySettings

Represents global settings that affect multiple features in your organization. This type extends the Metadata metadata type and inherits its fullName field.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for details.

## Declarative Metadata File Suffix and Directory Location

CompanySettings values are stored in a single file named Company.settings in the settings directory of the corresponding package directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

## Version

Company Profile Settings are available in API version 27.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| enableCustomFiscalYear | boolean | If a custom fiscal period is set up, this field is used to determine whether the custom fiscal period is used for forecasts. If true, the custom fiscal period is used. If false (default), standard periods are used. Available in API version 47.0 and later. |
| fiscalYear | [FiscalYearSetting](#CompanyProfileSettingsFiscalYear) | The organization’s fiscal year setting based on year and start month. Not available if Custom Fiscal Year or Forecasts (Classic) is enabled. When changing fiscal year settings, quotas and adjustments can be purged. For example changing your start month results in purging this data. |

## FiscalYearSetting

Represents your organization’s fiscal year setting.

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d261111e176">Field</th>

              <th class="featureTableHeader  " id="d261111e179">Field Type</th>

              <th class="featureTableHeader  " id="d261111e182">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d261111e176" data-title="Field"><span class="keyword parmname" id="field_fiscalyearnamebasedon"><a name="field_fiscalyearnamebasedon"><!-- --></a>fiscalYearNameBasedOn</span></td>

              <td class="entry" headers="d261111e179" data-title="Field Type">string</td>

              <td class="entry" headers="d261111e182" data-title="Description">
                <span class="ph" id="fiscalYearNameBasedOnDesc"><a name="fiscalYearNameBasedOnDesc"><!-- --></a>This field is used to
                  determine the fiscal year name. Valid values are <samp class="codeph nolang">endingMonth</samp> or <samp class="codeph nolang">startingMonth</samp>. For example, if
                  your fiscal year starts in April 2012 and ends in March 2013,
                  and this value is:</span>
                <ul class="ul bulletList">
                  <li class="li">
                    <samp class="codeph nolang">endingMonth</samp>, then 2013
                    is used for the fiscal year name.
                  </li>

                  <li class="li">
                    <samp class="codeph nolang">startingMonth</samp>, then
                    2012 is used for the fiscal year name.
                  </li>

                </ul>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d261111e176" data-title="Field"><span class="keyword parmname" id="field_startmonth"><a name="field_startmonth"><!-- --></a>startMonth</span></td>

              <td class="entry" headers="d261111e179" data-title="Field Type">string</td>

              <td class="entry" headers="d261111e182" data-title="Description"><span class="ph" id="startMonthDesc"><a name="startMonthDesc"><!-- --></a>The month on which the fiscal year is
                  based.</span></td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition — Fiscal Year Setting

A sample XML definition of a fiscal year setting is shown below. Note that this example is supported in API version 27.0 and later.

<?xml version="1.0" encoding="UTF-8"?>
<CompanySettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <fiscalYear\>
        <fiscalYearNameBasedOn\>endingMonth</fiscalYearNameBasedOn\>
        <startMonth\>January</startMonth\>
    </fiscalYear\>
</CompanySettings\>

## Wildcard Support in the Manifest File

The wildcard character \* (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see [Settings](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).