diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/_category_.json
new file mode 100644
index 0000000000..6a71ae3e79
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "OpenCost",
+ "position": 1
+}
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/_opencost-docker-parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/_opencost-docker-parameters.mdx
similarity index 100%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/_opencost-docker-parameters.mdx
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/_opencost-docker-parameters.mdx
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/aws.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/aws.md
new file mode 100644
index 0000000000..f01ec0843e
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/aws.md
@@ -0,0 +1,210 @@
+---
+description: Set up AWS cloud cost tracking using OpenCost
+---
+
+# Track AWS cloud costs using OpenCost
+This guide will help you set up AWS Cost and Usage Reports (CUR) with OpenCost to track your AWS cloud costs in Port.
+By default, OpenCost pulls on-demand asset prices from the public AWS pricing API.
+The AWS Pricing API is limited in its resolution capabilities, not allowing per-resource costs analysis and deep granularity.
+
+To allow for a more granular resolution of your AWS cost data, OpenCost supports ingesting pricing data from [CUR reports](https://docs.aws.amazon.com/cur/latest/userguide/what-is-cur.html).
+In this guide, we will use the OpenCost price capabilities leveraging AWS CUR, and Port's [Ocean OpenCost integration](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md), to ingest per-resource cost entities into Port.
+
+## Common use cases
+
+- Track cloud spending across different AWS services
+- Monitor costs per team or project
+- Create cost allocation reports
+- Analyze cost trends over time
+
+## Prerequisites
+
+1. An AWS account with the following permissions:
+
+ IAM Permissions (Click to expand)
+
+ ```json showLineNumbers
+ {
+ "Version": "2012-10-17",
+ "Statement": [
+ {
+ "Effect": "Allow",
+ "Action": [
+ "organizations:DescribeOrganization"
+ ],
+ "Resource": "*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "s3:GetBucketTagging",
+ "s3:PutBucketTagging",
+ "s3:GetBucketPolicy",
+ "s3:PutBucketPolicy",
+ "s3:ListBucket",
+ "s3:CreateBucket"
+ ],
+ "Resource": "arn:aws:s3:::aws-map-cur-bucket-*"
+ },
+ {
+ "Effect": "Allow",
+ "Action": [
+ "cur:PutReportDefinition",
+ "cur:DeleteReportDefinition",
+ "cur:DescribeReportDefinitions"
+ ],
+ "Resource": "arn:aws:cur:*:*:definition/map-migrated-report"
+ },
+ {
+ "Effect": "Allow",
+ "Action": "cur:DescribeReportDefinitions",
+ "Resource": "*"
+ }
+ ]
+ }
+ ```
+
+
+2. Set up OpenCost with AWS CUR using [this guide](https://docs.kubecost.com/install-and-configure/install/cloud-integration/aws-cloud-integrations).
+
+ This guide uses KubeCost documentation, but the steps are the same for setting up OpenCost.
+ :::info Cost Report Delay
+ After setting up AWS CUR, it may take up to 24 hours for the first cost report to be generated and available in OpenCost.
+ :::
+
+3. Install Port's [OpenCost integration](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md#installation).
+
+
+
+## Set up data model
+
+After installing Port's OpenCost integration, The **OpenCost CloudCost** [blueprint](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/) will be created for you automatically.
+This blueprint represents an OpenCost CloudCost entity. If the blueprint **does not** exist,
+
+Follow these steps to add it:
+
+1. Navigate to your Port organization's [data model](https://app.getport.io/settings/data-model) page.
+2. Click on the `+ Blueprint` button.
+3. Click on `Edit JSON` button.
+4. Copy-paste the following blueprint JSON:
+
+
+ OpenCost CloudCost blueprint (Cick to expand)
+
+ ```json showLineNumbers
+ {
+ "identifier": "openCostCloudcost",
+ "description": "This blueprint represents cloud cost allocations from your OpenCost instance",
+ "title": "OpenCost CloudCost",
+ "icon": "Opencost",
+ "schema": {
+ "properties": {
+ "startDate": {
+ "title": "Start Date",
+ "type": "string",
+ "format": "date-time"
+ },
+ "endDate": {
+ "title": "End Date",
+ "type": "string",
+ "format": "date-time"
+ },
+ "listCost": {
+ "title": "List Cost",
+ "type": "number"
+ },
+ "netCost": {
+ "title": "Net Cost",
+ "type": "number"
+ },
+ "amortizedNetCost": {
+ "title": "Amortized Net Cost",
+ "type": "number"
+ },
+ "invoicedCost": {
+ "title": "Invoiced Cost",
+ "type": "number"
+ },
+ "amortizedCost": {
+ "title": "Amortized Cost",
+ "type": "number"
+ }
+ },
+ "required": []
+ },
+ "mirrorProperties": {},
+ "calculationProperties": {},
+ "aggregationProperties": {},
+ "relations": {}
+ }
+ ```
+
+
+
+5. Cick on `Save`.
+
+## Add mapping configuration
+
+Now that we have defined our data model, let us update the **OpenCost mapping configuration** to ingest the relevant cost data in Port.
+**OpenCost cloudcost** data supports a variety of time windows, aggregations and filters.
+
+In this guide, the data that will be ingested is the cost of all `AmazonEC2` resources in the past week.
+If you installed the OpenCost integration, a `cloudcost` config block was added automatically - in this case, replace the pre-existing config.
+If you haven't installed the integration and only created the blueprint, add the following YAML snippet as your `cloudcost` configuration:
+
+Follow these steps to update the OpenCost mapping configuration:
+
+1. Navigate to your [datasources page](https://app.getport.io/settings/data-sources), and click on the `OpenCost` datasource.
+
+2. Add the following configuration to your datasource mapping:
+
+
+ OpenCost CloudCost mapping configuration (Click to expand)
+
+ ```yaml showLineNumbers
+ - kind: cloudcost
+ selector:
+ query: .properties.providerID
+ aggregate: providerID
+ accumulate: week
+ window: week
+ filter: service:"AmazonEC2"
+ port:
+ entity:
+ mappings:
+ identifier: .properties.providerID
+ title: .properties.providerID
+ blueprint: '"openCostCloudcost"'
+ properties:
+ startDate: .window.start
+ endDate: .window.end
+ listCost: .listCost.cost
+ netCost: .netCost.cost
+ amortizedNetCost: .amortizedNetCost.cost
+ invoicedCost: .invoicedCost.cost
+ amortizedCost: .amortizedCost.cost
+ ```
+
+
+
+ :::tip Service selector
+
+ The `.selector.filter.service` field is **required**, and represents the AWS service type (AWS Namespace) we want to ingest.
+
+ We use the `.properties.providerID` field to get the ARN of the AWS resource. Some AWS resources do not have a full ARN as their ID and are ingested as regular IDs.
+
+ For example, an entity which represents an EC2 instance will be ingested to Port with `i-abc123abc123ab` as its identifier.
+
+ :::
+
+3. Click on `Save & Resync` .
+
+4. Now, navigate to your [OpenCost CloudCost](https://app.getport.io/openCostCloudcosts) entities page, and you should see your `AmazonEC2` resources, and their different price types.
+
+## Conclusion
+
+Using Port Ocean's OpenCost integration, we have successfully ingested AWS resources' cost data into our Port organization!
+
+
+
+
\ No newline at end of file
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost.md b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md
similarity index 98%
rename from docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost.md
rename to docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md
index 3e29311282..8668773818 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost.md
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md
@@ -1,9 +1,9 @@
import Tabs from "@theme/Tabs"
import TabItem from "@theme/TabItem"
-import Prerequisites from "../templates/\_ocean_helm_prerequisites_block.mdx"
-import AzurePremise from "../templates/\_ocean_azure_premise.mdx"
+import Prerequisites from "../../templates/\_ocean_helm_prerequisites_block.mdx"
+import AzurePremise from "../../templates/\_ocean_azure_premise.mdx"
import DockerParameters from "./\_opencost-docker-parameters.mdx"
-import AdvancedConfig from '../../../generalTemplates/_ocean_advanced_configuration_note.md'
+import AdvancedConfig from '../../../../generalTemplates/_ocean_advanced_configuration_note.md'
import PortApiRegionTip from "/docs/generalTemplates/_port_region_parameter_explanation_template.md"
import OceanRealtimeInstallation from "/docs/build-your-software-catalog/sync-data-to-catalog/templates/_ocean_realtime_installation.mdx"
diff --git a/docs/integrations-index.md b/docs/integrations-index.md
index bdf8a98560..6de9b76417 100644
--- a/docs/integrations-index.md
+++ b/docs/integrations-index.md
@@ -236,7 +236,7 @@ This page contains a list of Port's available integrations, organized by the pla
## OpenCost
-- [OpenCost integration](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost.md)
+- [OpenCost integration](/build-your-software-catalog/sync-data-to-catalog/cloud-cost/opencost/opencost.md)
## Dynatrace
diff --git a/static/img/integrations/opencost/opencostCloudcostResources.png b/static/img/integrations/opencost/opencostCloudcostResources.png
new file mode 100644
index 0000000000..daebbf8e11
Binary files /dev/null and b/static/img/integrations/opencost/opencostCloudcostResources.png differ